RibbonDropDown 接口
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示一个用户可从中选择的项列表，以及一个用户可单击的功能区列表。
public interface class RibbonDropDown : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent[System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent[<System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")>]
type RibbonDropDown = interface
interface RibbonControl
interface RibbonComponent
interface IComponent
interface IDisposablePublic Interface RibbonDropDown
Implements IComponent, IDisposable, RibbonControl- 属性
- 实现
注解
可以 RibbonDropDown 包含 RibbonDropDownItem 对象和 RibbonButton 控件。
可以使用 对象的 方法RibbonFactory在运行时CreateRibbonDropDown创建 RibbonDropDown 。
可通过两种方法来访问 RibbonFactory 对象：
通过使用 Ribbon 类的
Factory属性。 可从 Ribbon 类中的代码使用此方法。通过使用
Globals.Factory.GetRibbonFactory方法。 可从 Ribbon 类外的代码使用此方法。
在功能区加载到 Buttons Office 后，无法在运行时将按钮添加到集合。
以下过程说明如何将对象和RibbonButton控件添加到 。RibbonDropDownItemRibbonDropDown
在设计时添加 RibbonDropDownItem 对象
单击“属性”窗口中的“项”属性。
单击省略号 (...) 。
在 DropDown 集合编辑器，添加、排序和编辑新项。
可以在设计时将控件添加到 RibbonButtonRibbonDropDown 。
在设计时添加 RibbonButton 控件
单击“属性”窗口中的“按钮”属性。
单击省略号 (...) 。
在 Button 集合编辑器，添加、排序和编辑新的按钮控件。
只能在将功能区加载到 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 |
获取属于此 RibbonDropDown 的 RibbonButton 对象集合。 |
| Enabled |
获取或设置一个值，该值指示是否启用此 RibbonControl。 (继承自 RibbonControl) |
| Id |
获取一个字符串，Microsoft Office 将用其标识此 RibbonControl 对象。 (继承自 RibbonControl) |
| Image |
获取或设置显示在此 RibbonDropDown 上的图像。 |
| ImageName |
获取或设置一个名称，该名称可用于在 LoadImage 事件处理程序中标识控件图像。 |
| Items |
获取此 RibbonDropDown 中项的集合。 |
| KeyTip |
获取或设置此 RibbonDropDown 的键盘快捷键。 |
| Label |
获取或设置此 RibbonDropDown 上显示的文本。 |
| Name |
获取或设置此 RibbonComponent 的名称。 (继承自 RibbonComponent) |
| OfficeImageId |
如果要使用内置 Microsoft Office 图标，请获取或设置要在 RibbonDropDown 上显示的图像。 |
| Parent |
获取一个 RibbonComponent，表示此 RibbonComponent 的父级。 (继承自 RibbonComponent) |
| Ribbon |
获取包含控件层次结构的顶级 Ribbon 对象。 (继承自 RibbonComponent) |
| RibbonUI |
获取 Microsoft Office 应用程序提供给功能区扩展性代码的 IRibbonUI 实例。 (继承自 RibbonComponent) |
| ScreenTip |
获取或设置用户将指针移到 RibbonDropDown 上方时显示的提示文本。 |
| SelectedItem |
获取或设置当前选定的 RibbonDropDownItem。 |
| SelectedItemIndex |
获取或设置当前选定的 RibbonDropDownItem 的索引。 |
| ShowImage |
获取或设置一个值，该值指示与 RibbonDropDown 关联的图像是否可见。 |
| ShowItemImage |
获取或设置一个值，该值指示是否为下拉菜单中的项显示图像。 |
| ShowItemLabel |
获取或设置一个值，该值指示是否为下拉菜单中的项显示标签。 |
| ShowLabel |
获取或设置一个值，该值指示此 RibbonDropDown 的标签是否可见。 |
| SizeString |
获取或设置一个字符串，该字符串确定 RibbonDropDown 的大小。 |
| SuperTip |
获取或设置用户将指针移到 RibbonDropDown 上时显示的多行提示文本。 |
| 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 |
用户单击 RibbonDropDown 上的按钮时发生。 |
| ItemsLoading |
在向 RibbonDropDown 中加载控件时发生。 |
| SelectionChanged |
当用户在功能区下拉控件中选择新项时发生。 |