RibbonGroup 介面

定義

命名空間:

Microsoft.Office.Tools.Ribbon

組件:

Microsoft.Office.Tools.Common.dll

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

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 IDisposable

Public Interface RibbonGroup
Implements IComponent, IDisposable, RibbonComponent

屬性

GuidAttribute

實作

RibbonComponent IComponent IDisposable

備註

當您將 [工具箱] 的 [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

發生於使用者按一下群組中的功能區對話方塊啟動程式圖示時。