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与 接口不同， 接口在RibbonGalleryClick用户单击 RibbonDropDownItem时引发事件，而不是SelectionChanged事件。 这意味着，例如， Click 当用户单击同 RibbonDropDownItem 一事件两次时，将引发两次事件。 (当 SelectionChanged 对 上的同一方案进行初始选择时，最多会引发一 RibbonDropDown次事件，具体取决于第一次单击之前所选内容。)

属性 ShowItemSelection 控制当前所选 RibbonDropDownItem 的 是否在视觉上与未选择的项区分开来。 一次只能选择一项 RibbonGallery。

属性 ItemImageSize 可用于指定 16x16 和 32x32 以外的图像大小。

在设计时添加 RibbonDropDownItem 对象

1. 在“属性”窗口中单击“项”属性。

2. 单击省略号 (...) 。

3. 在 DropDown 集合编辑器，添加、排序和编辑新项。

可以在设计时将控件添加到 RibbonButtonRibbonGallery 。

在设计时添加 RibbonButton 控件

1. 单击“属性”窗口中的“按钮”属性。

2. 单击省略号 (...) 。

3. 在按钮集合编辑器，添加、排序和编辑新的按钮控件。

可以在运行时使用 CreateRibbonGallery 对象的 方法RibbonFactory创建 RibbonGallery 。

可通过两种方法来访问 RibbonFactory 对象：

• 通过使用 Ribbon 类的 Factory 属性。 可从 Ribbon 类中的代码使用此方法。

• 通过使用 Globals.Factory.GetRibbonFactory 方法。 可从 Ribbon 类外的代码使用此方法。

只能在将功能区加载到 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	获取或设置此 中的“项”列的数量RibbonGallery。
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 的父级。 (继承自 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 时发生。