OfficeRibbon 介面

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

命名空間:  Microsoft.Office.Tools.Ribbon
組件:   Microsoft.Office.Tools.Common.v4.0.Utilities (在 Microsoft.Office.Tools.Common.v4.0.Utilities.dll 中)
  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)。

回頁首

方法

  名稱 說明
公用方法 _VtblGap1_2 基礎架構。
公用方法 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 和 .NET Framework 4.5 為目標之 Office 專案的版本。在以 .NET Framework 3.5 為目標的專案中,此類型可能會有不同的成員,而為此類型提供的程式碼範例可能無法運作。如需此類型在以 .NET Framework 3.5 為目標之專案中的相關文件,請參閱下列 Visual Studio 2008 文件中的參考章節:https://go.microsoft.com/fwlink/?LinkId=160658

請參閱

參考

Microsoft.Office.Tools.Ribbon 命名空間