RibbonGroup 介面

發行項
08/12/2011

表示功能區索引標籤上的控制項群組。

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

語法

'宣告
<GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")> _
Public Interface RibbonGroup _
    Inherits RibbonComponent, IComponent, IDisposable

[GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : RibbonComponent, 
    IComponent, IDisposable

RibbonGroup 型別會公開下列成員。

屬性

	名稱	說明
	DialogLauncher	取得或設定與群組關聯的功能區對話方塊啟動程式。
	Id	取得識別目前群組的字串。
	Items	取得群組中的控制項。
	KeyTip	取得或設定群組的鍵盤快速鍵。
	Label	取得或設定群組的標籤所顯示的文字。
	Name	取得或設定這個 RibbonComponent 的名稱。 (繼承自 RibbonComponent)。
	Parent	取得 RibbonComponent，表示這個 RibbonComponent 的父代 (Parent)。 (繼承自 RibbonComponent)。
	Position	取得或設定群組在內建索引標籤中相對於內建群組的位置。
	Ribbon	取得包含控制項階層架構的最上層 Ribbon 物件。 (繼承自 RibbonComponent)。
	RibbonUI	基礎架構。取得 Microsoft Office 應用程式提供給功能區擴充性程式碼的 IRibbonUI 執行個體。 (繼承自 RibbonComponent)。
	Site	取得或設定與 IComponent 相關聯的 ISite。 (繼承自 IComponent)。
	Tag	取得或設定與這個 RibbonComponent 關聯的應用程式特定資料。 (繼承自 RibbonComponent)。
	Visible	取得或設定值，指出群組是否可見。

回頁首

方法

	名稱	說明
	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)。

回頁首

事件

	名稱	說明
	DialogLauncherClick	會在使用者按一下群組中的功能區對話方塊啟動程式圖示時發生。
	Disposed	表示處理元件的 Disposed 事件的方法。 (繼承自 IComponent)。

回頁首

備註

當您將 [群組] 控制項從 [工具箱] 的 [Office 功能區控制項] 索引標籤拖曳至功能區設計工具時，Visual Studio 會建立 RibbonGroup 物件。

一般工作

下表列出適用於一般工作的成員。這些工作都可以在設計階段進行。其中有些工作可以在功能區載入之前的執行階段進行。如需詳細資訊，請參閱功能區物件模型概觀。

工作	成員
存取群組中的控制項、加入控制項至群組或移除群組中的控制項。	使用 Items 屬性。
將群組加入至功能區索引標籤。	將 RibbonGroup 加入至索引標籤的 Groups 集合。
指定群組在內建索引標籤中相對於內建群組的位置。	使用 Position 屬性。

您可以在執行階段中使用 RibbonFactory 物件的 CreateRibbonGroup 方法建立 RibbonGroup。

有兩種方法可以存取 RibbonFactory 物件：

使用功能區類別的 Factory 屬性。請從功能區類別中的程式碼使用此方法。
使用 Globals.Factory.GetRibbonFactory 方法。請從功能區類別外的程式碼使用此方法。

注意事項
此介面是由 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 (英文)。