RibbonGallery 介面

定義

命名空間:

Microsoft.Office.Tools.Ribbon

組件:

Microsoft.Office.Tools.Common.dll

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

public interface class RibbonGallery : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")>]
type RibbonGallery = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonGallery
Implements IComponent, IDisposable, RibbonControl

屬性

GuidAttribute

實作

RibbonComponent RibbonControl IComponent IDisposable

備註

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

RibbonDropDown不同於介面，RibbonGallery介面會在Click用戶按兩下RibbonDropDownItem時引發事件，而不是SelectionChanged事件。 例如， Click 這表示當用戶按兩次 RibbonDropDownItem 時，就會引發事件兩次。 SelectionChanged (根據第一次 click.) 之前選取專案，在上針對相同案例RibbonDropDown進行初始選取時，最多會引發一次此事件。

屬性 ShowItemSelection 可控制目前選取 RibbonDropDownItem 的專案是否以視覺方式區分不選取的專案。 一次只能選取一 RibbonGallery個專案。

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

在設計時間新增 RibbonDropDownItem 物件

1. 按兩下 [屬性] 視窗中的 [專案] 屬性。

2. 按一下省略符號 (...)。

3. 在DropDown集合編輯器、新增、排序和編輯新專案。

您可以在設計時間將控制項新增 RibbonButton 至 RibbonGallery 。

在設計時間新增 RibbonButton 控制件

1. 按兩下 [屬性] 視窗中的 Buttons 屬性。

2. 按一下省略符號 (...)。

3. 在 [按鈕集合] 編輯器 中，新增、排序和編輯新的按鈕控件。

您可以使用物件的 方法RibbonFactory，CreateRibbonGallery在執行時間建立 RibbonGallery 。

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

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

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

此控制項的某些屬性只能在功能區載入 Office 應用程式之前設定，或在運行時間將控制項新增至動態功能表之前設定。 如需設定這些屬性的詳細資訊，請參閱 功能區物件模型概觀。

注意

這個介面是由 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。

屬性

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

方法

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)

事件

ButtonClick	發生在使用者按一下這個 RibbonGallery 上的按鈕時。
Click	發生在使用者按一下這個 RibbonGallery 上的項目時。
ItemsLoading	發生於開啟這個 RibbonGallery 時。