共用方式為


RibbonGallery 類別 (2007 系統)

更新:2007 年 11 月

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

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

語法

<ToolboxBitmapAttribute(GetType(RibbonGallery), "RibbonGallery.bmp")> _
Public NotInheritable Class RibbonGallery _
    Inherits RibbonControl

Dim instance As RibbonGallery
[ToolboxBitmapAttribute(typeof(RibbonGallery), "RibbonGallery.bmp")]
public sealed class RibbonGallery : RibbonControl

備註

就像 RibbonDropDown 類別一樣,RibbonGallery 也會顯示 RibbonDropDownItem 物件和 RibbonButton 控制項的功能表。

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

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

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

您可以在設計階段或執行階段,將 RibbonDropDownItem 物件加入至 RibbonGallery。

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

  1. 按一下 [屬性] 視窗中的 [Items] 屬性。

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

  3. 在 [DropDown 集合編輯器] 中,加入、排序和編輯新項目。

下列步驟說明如何在執行階段加入 RibbonDropDownItem

若要在執行階段新增 RibbonDropDownItem 物件

  1. 使用 RibbonDropDownItem 建立新的 RibbonDropDownItem

  2. 將您建立的 RibbonDropDownItem 加入至這個 RibbonGallery 物件的 Items 集合。

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

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

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

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

  3. 在 [Button 集合編輯器] 中,加入、排序和編輯新按鈕控制項。

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

繼承階層架構

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonComponent
        Microsoft.Office.Tools.Ribbon.RibbonControl
          Microsoft.Office.Tools.Ribbon.RibbonGallery

執行緒安全

這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。

請參閱

參考

RibbonGallery 成員

Microsoft.Office.Tools.Ribbon 命名空間

其他資源

功能區概觀

功能區設計工具

功能區物件模型概觀

HOW TO:開始自訂功能區