RibbonGallery 类 (2007 system)

更新: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. 在“按钮集合编辑器”中添加新按钮控件并对其进行排序和编辑。

此控件的某些属性只能在运行时设置,并且只能在功能区加载到 Office 应用程序之前,或者该控件添加到动态菜单之前进行设置。有关如何设置这些属性的信息,请参见功能区对象模型概述

继承层次结构

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

线程安全

此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

另请参见

参考

RibbonGallery 成员

Microsoft.Office.Tools.Ribbon 命名空间

其他资源

功能区概述

功能区设计器

功能区对象模型概述

如何:开始自定义功能区