RibbonGroup 介面
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表功能區索引標籤上的控制項群組。
public interface class RibbonGroup : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonComponent, System::ComponentModel::IComponent[System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent[<System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")>]
type RibbonGroup = interface
interface RibbonComponent
interface IComponent
interface IDisposablePublic Interface RibbonGroup
Implements IComponent, IDisposable, RibbonComponent- 屬性
- 實作
備註
當您將 [工具箱] 的 [Office 功能區控件] 索引標籤拖曳至功能區 Designer 時，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 Overview。
使用方式
本文件說明此類型的版本，其會用在目標為 .NET Framework 4 或更新版本的 Office 專案中。 在以 .NET Framework 3.5 為目標的專案中，此類型可能會有不同的成員，而為此類型提供的程式碼範例可能無法運作。 如需此類型在以 .NET Framework 3.5 為目標專案中的相關文件，請參閱下列 Visual Studio 2008 文件中的參考章節：http://go.microsoft.com/fwlink/?LinkId=160658。
屬性
| DialogLauncher |
取得或設定與群組關聯的功能區啟動程式。 |
| Id |
取得識別目前群組的字串。 |
| Items |
取得群組中的控制項。 |
| KeyTip |
取得或設定群組的鍵盤快速鍵。 |
| Label |
取得或設定群組標籤所顯示的文字。 |
| Name |
取得或設定這個 RibbonComponent 的名稱。 (繼承來源 RibbonComponent) |
| Parent |
取得 RibbonComponent，代表這個 RibbonComponent 的父代。 (繼承來源 RibbonComponent) |
| Position |
取得或設定內建索引標籤上群組的位置，其相對於索引標籤上的內建群組。 |
| Ribbon |
取得包含控制項階層的最上層 Ribbon 物件。 (繼承來源 RibbonComponent) |
| RibbonUI |
取得 Microsoft Office 應用程式提供給功能區擴充性程式碼的 IRibbonUI 執行個體。 (繼承來源 RibbonComponent) |
| Tag |
取得或設定與這個 RibbonComponent 關聯的應用程式特定資料。 (繼承來源 RibbonComponent) |
| Visible |
取得或設定值，指出群組是否可見。 |
方法
| PerformDynamicLayout() |
如果 RibbonComponent 具有動態功能表這類動態父代，而且未暫止配置，請呼叫父控制項的 Microsoft.Office.Core.IRibbonUI.InvalidateControl 方法。 (繼承來源 RibbonComponent) |
| PerformLayout() |
如果 具有父代，而且未暫止配置，請呼叫 RibbonComponentMicrosoft.Office.Core.IRibbonUI.InvalidateControl。 (繼承來源 RibbonComponent) |
| ResumeLayout() |
回復 SuspendLayout() 方法的效果。 (繼承來源 RibbonComponent) |
| ResumeLayout(Boolean) |
回復 SuspendLayout() 方法的效果。 (繼承來源 RibbonComponent) |
| SuspendLayout() |
防止 Microsoft Office 應用程式重新整理功能區上控制項的狀態。 (繼承來源 RibbonComponent) |
事件
| DialogLauncherClick |
發生於使用者按一下群組中的功能區對話方塊啟動程式圖示時。 |