RibbonGallery 介面

發行項
01/03/2014

表示顯示 RibbonDropDownItem 物件和 RibbonButton 控制項之功能表的控制項。

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

語法

'宣告
<GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")> _
Public Interface RibbonGallery _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

RibbonGallery 型別會公開下列成員。

屬性

	名稱	說明
	Buttons	取得這個 RibbonGallery 上的按鈕集合。
	ColumnCount	取得或設定這個 RibbonGallery 中的 Item 欄數。
	ControlSize	取得或設定 RibbonGallery 控制項的大小。
	Description	取得或設定會在功能表或分割按鈕中顯示於這個 RibbonGallery 控制項的文字。
	Enabled	取得或設定值，指出此 RibbonControl 是否已啟用。 (繼承自 RibbonControl)。
	Id	取得 Microsoft Office 用來識別這個 RibbonControl 物件的字串。 (繼承自 RibbonControl)。
	Image	取得或設定顯示在按鈕上的影像。
	ImageName	取得或設定可在 LoadImage 事件處理常式中用來識別 RibbonGallery 的名稱。
	ItemImageSize	取得或設定 Size，這會指定此 RibbonGallery 中的項目所顯示之影像的尺寸。
	Items	取得這個 RibbonGallery 中 RibbonDropDownItem 元件的集合。
	KeyTip	取得或設定這個 RibbonGallery 的鍵盤快速鍵。
	Label	取得或設定出現在這個 RibbonGallery 上的文字。
	Name	取得或設定這個 RibbonComponent 的名稱。 (繼承自 RibbonComponent)。
	OfficeImageId	取得或設定要顯示在控制項上的影像 (如果您想要使用內建 Microsoft Office 圖示的話)。
	Parent	取得 RibbonComponent，表示這個 RibbonComponent 的父代 (Parent)。 (繼承自 RibbonComponent)。
	Position	取得或設定圖庫的位置 (如果圖庫在 Microsoft Office 功能表上的話)。
	Ribbon	取得包含控制項階層架構的最上層 Ribbon 物件。 (繼承自 RibbonComponent)。
	RibbonUI	基礎架構。取得 Microsoft Office 應用程式提供給功能區擴充性程式碼的 IRibbonUI 執行個體。 (繼承自 RibbonComponent)。
	RowCount	取得或設定這個 RibbonGallery 顯示的 RibbonDropDownItem 元件列數。
	ScreenTip	取得或設定當使用者將游標移至這個 RibbonGallery 上方時所顯示的提示文字。
	SelectedItem	取得或設定目前選取的項目。
	SelectedItemIndex	取得或設定目前選取之 RibbonDropDownItem 的索引。
	ShowImage	取得或設定值，指出與 RibbonGallery 關聯的影像是否可見。
	ShowItemImage	取得或設定值，指出圖庫中的項目是否顯示影像。
	ShowItemLabel	取得或設定值，指出這個 RibbonGallery 上的項目是否顯示標籤。
	ShowItemSelection	取得或設定值，指出是否在視覺上區分目前選取的 RibbonDropDownItem 與其他未選取的項目。
	ShowLabel	取得或設定值，指出這個 RibbonGallery 的標籤是否可見。
	Site	取得或設定與 IComponent 相關聯的 ISite。 (繼承自 IComponent)。
	SuperTip	取得或設定當使用者將游標移至 RibbonGallery 上方時所顯示的多行提示文字。
	Tag	取得或設定與這個 RibbonComponent 關聯的應用程式特定資料。 (繼承自 RibbonComponent)。
	Visible	取得或設定值，指出此 RibbonControl 是否為可見的。 (繼承自 RibbonControl)。

回頁首

方法

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

回頁首

事件

	名稱	說明
	ButtonClick	會在使用者按一下這個 RibbonGallery 上的按鈕時發生。
	Click	會在使用者按一下這個 RibbonGallery 上的項目時發生。
	Disposed	表示處理元件的 Disposed 事件的方法。 (繼承自 IComponent)。
	ItemsLoading	會在開啟這個 RibbonGallery 時發生。

回頁首

備註

就像 RibbonDropDown 介面一樣，RibbonGallery 也會顯示 RibbonDropDownItem 物件和 RibbonButton 控制項的功能表。

不像 RibbonDropDown 介面，當使用者按一下 RibbonDropDownItem 時 RibbonGallery 介面會引發 Click 事件，而不是 SelectionChanged 事件。舉例來說，這表示當使用者按兩次相同的 RibbonDropDownItem 時，就會引發兩次 Click 事件 (視第一個按一下動作之前所做的選取而定，在相同情況下初次選取 RibbonDropDown 時，最多只會引發一次 SelectionChanged 事件)。

ShowItemSelection 屬性會控制是否在視覺上區別目前選取的 RibbonDropDownItem 與未選取的項目。在 RibbonGallery 中，一次只能選取一個項目。

ItemImageSize 屬性可以用來指定 16x16 和 32x32 以外的影像大小。

若要在設計階段加入 RibbonDropDownItem 物件

按一下 [屬性] 視窗中的 [Items] 屬性。
按一下省略符號 (...)。
在 [DropDown 集合編輯器] 中，加入、排序和編輯新項目。

您可以在設計階段，將 RibbonButton 控制項加入至 RibbonGallery。

若要在設計階段加入 RibbonButton 控制項

按一下 [屬性] 視窗中的 [Buttons] 屬性。
按一下省略符號 (...)。
在 [Button 集合編輯器] 中，加入、排序和編輯新按鈕控制項。

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

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

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

這個控制項的某些屬性只能在功能區載入至 Office 應用程式前進行設定，或在執行階段控制項加入至動態功能表之前進行設定。如需這些屬性的設定資訊，請參閱功能區物件模型概觀。

注意事項
這個介面是由 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。