OfficeRibbon 介面

表示在 Visual Studio 的 Office 專案中使用 Ribbon Designer 建立的 Microsoft Office Ribbon 自訂。

命名空間：  Microsoft.Office.Tools.Ribbon
組件：  Microsoft.Office.Tools.Common (在 Microsoft.Office.Tools.Common.dll 中)

語法

'宣告
<GuidAttribute("49fbf223-6d24-4c4b-9101-2d5833434328")> _
Public Interface OfficeRibbon _
    Inherits RibbonComponent, IComponent, IDisposable

[GuidAttribute("49fbf223-6d24-4c4b-9101-2d5833434328")]
public interface OfficeRibbon : RibbonComponent, 
    IComponent, IDisposable

OfficeRibbon 型別會公開下列成員。

屬性

	名稱	說明
	Context	取得 Outlook 中與這個功能區相關聯的 [偵測器] 視窗或 [總管] 視窗。
	DefaultExtension	取得這個 OfficeRibbon 物件的預設副檔名。
	Extension	取得這個 OfficeRibbon 物件的自訂副檔名。
	Global	取得或設定值，這個值會判斷此 OfficeRibbon 是否可以同時在多個內容中使用。
	Name	取得或設定這個 RibbonComponent 的名稱。 (繼承自 RibbonComponent)。
	OfficeMenu	取得 RibbonOfficeMenu，表示 Microsoft Office 功能表自訂。
	Parent	取得 RibbonComponent，表示這個 RibbonComponent 的父代 (Parent)。 (繼承自 RibbonComponent)。
	Ribbon	取得包含控制項階層架構的最上層 Ribbon 物件。 (繼承自 RibbonComponent)。
	RibbonId	取得已用於建立這個 OfficeRibbon 物件執行個體的功能區 ID。
	RibbonType	取得與這個 OfficeRibbon 執行個體關聯之功能區 ID 的逗號分隔清單。
	RibbonUI	基礎架構。取得 Microsoft Office 應用程式提供給功能區擴充性程式碼的 IRibbonUI 執行個體。 (繼承自 RibbonComponent)。
	Site	取得或設定與 IComponent 相關聯的 ISite。 (繼承自 IComponent)。
	StartFromScratch	取得或設定值，這個值表示是否要隱藏功能區上的所有內建索引標籤以及 Microsoft Office 功能表上的大部分命令，並且只顯示此功能區項目內定義的自訂。
	Tabs	取得 RibbonOfficeMenu 中的 RibbonTab 物件集合。
	Tag	取得或設定與這個 RibbonComponent 關聯的應用程式特定資料。 (繼承自 RibbonComponent)。

回頁首

方法

	名稱	說明
	Dispose	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承自 IDisposable)。
	PerformDynamicLayout	如果 RibbonComponent 具有像是動態功能表的動態父代 (Parent)，而且配置未暫止，請呼叫父控制項的 Microsoft.Office.Core.IRibbonUI.InvalidateControl 方法。 (繼承自 RibbonComponent)。
	PerformLayout	如果 RibbonComponent 具有父代且配置未暫止，則會呼叫 Microsoft.Office.Core.IRibbonUI.InvalidateControl。 (繼承自 RibbonComponent)。
	ResumeLayout()	回復 SuspendLayout 方法的效果。 (繼承自 RibbonComponent)。
	ResumeLayout(Boolean)	回復 SuspendLayout 方法的效果。 (繼承自 RibbonComponent)。
	SuspendLayout	防止 Microsoft Office 應用程式重新整理功能區上控制項的狀態。 (繼承自 RibbonComponent)。

回頁首

事件

	名稱	說明
	Close	會在關閉這個 OfficeRibbon 執行個體時發生。
	Disposed	表示處理元件的 Disposed 事件的方法。 (繼承自 IComponent)。
	Load	會在 OfficeRibbon 載入至 Microsoft Office 應用程式時發生。
	LoadImage	會在 OfficeRibbon 載入時發生 (如果有一個或多個控制項的 ImageName 屬性已設定的話)。

回頁首

備註

您通常不會直接使用 OfficeRibbon 介面。 而是在您將新的 [功能區 (視覺化設計工具)] 項目加入至專案時，使用 Visual Studio 產生的功能區類別。 您可以使用產生之功能區類別中的事件和屬性，完成與功能區相關的大部分工作。

產生的功能區類別是繼承自 RibbonBase 類別。 這個基底類別會將其成員的所有呼叫重新導向至 Visual Studio Tools for Office Runtime 中 OfficeRibbon 介面的內部實作。 如果您要直接使用 OfficeRibbon物件，請使用所產生之功能區類別的 Base屬性。

注意事項
此介面是由 Visual Studio Tools for Office Runtime 所實作， 並不能實作於您的程式碼中。 如需詳細資訊，請參閱 Visual Studio Tools for Office Runtime 概觀。

使用方式

本文件說明此型別用於以 .NET Framework 4 為目標之 Office 專案的版本。在以 .NET Framework 3.5 為目標的專案中，此型別可能會有不同的成員，而為此型別提供的程式碼範例可能無法運作。 如需此型別在以 .NET Framework 3.5 為目標之專案中的相關文件，請參閱下列 Visual Studio 2008 文件中的參考章節：https://go.microsoft.com/fwlink/?LinkId=160658 (英文)。

請參閱

參考

Microsoft.Office.Tools.Ribbon 命名空間