RibbonDropDown 接口

项目
05/20/2013

表示用户可以从中进行选择的项列表和用户可以单击的功能区按钮列表。

命名空间： Microsoft.Office.Tools.Ribbon
程序集： Microsoft.Office.Tools.Common（在 Microsoft.Office.Tools.Common.dll 中）

语法

声明
<GuidAttribute("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")> _
Public Interface RibbonDropDown _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

RibbonDropDown 类型公开以下成员。

属性

	名称	说明
	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	获取或设置 RibbonDropDown 上显示的图像（如果要使用内置 Microsoft Office 图标）。
	Parent	获取一个表示此 RibbonComponent 的父级的 RibbonComponent。（继承自 RibbonComponent。）
	Ribbon	获取包含控件层次结构的顶级 Ribbon 对象。（继承自 RibbonComponent。）
	RibbonUI	基础结构。获取 Microsoft Office 应用程序提供给功能区扩展性代码的 IRibbonUI 实例。（继承自 RibbonComponent。）
	ScreenTip	获取或设置当用户将指针移到此 RibbonDropDown 上时显示的提示文本。
	SelectedItem	获取或设置当前选定的 RibbonDropDownItem。
	SelectedItemIndex	获取或设置当前选定的 RibbonDropDownItem 的索引。
	ShowImage	获取或设置一个值，该值指示与 RibbonDropDown 关联的图像是否可见。
	ShowItemImage	获取或设置一个值，该值指示是否为下拉菜单中的项显示图像。
	ShowItemLabel	获取或设置一个值，该值指示是否为下拉菜单中的项显示标签。
	ShowLabel	获取或设置一个值，该值指示此 RibbonDropDown 的标签是否可见。
	Site	获取或设置与 IComponent 关联的 ISite。（继承自 IComponent。）
	SizeString	获取或设置确定 RibbonDropDown 大小的字符串。
	SuperTip	获取或设置当用户将指针移到 RibbonDropDown 上时显示的多行提示文本。
	Tag	获取或设置与此 RibbonComponent 关联的特定于应用程序的数据。（继承自 RibbonComponent。）
	Visible	获取或设置一个值，该值指示此 RibbonControl 是否可见。（继承自 RibbonControl。）

页首

方法

	名称	说明
	Dispose	执行与释放或重置非托管资源相关的应用程序定义的任务。（继承自 IDisposable。）
	PerformDynamicLayout	如果 RibbonComponent 有一个动态父级（如动态菜单）且布局未挂起，则调用父控件的 Microsoft.Office.Core.IRibbonUI.InvalidateControl 方法。（继承自 RibbonComponent。）
	PerformLayout	如果 RibbonComponent 有父级，并且布局未挂起，则调用 Microsoft.Office.Core.IRibbonUI.InvalidateControl。（继承自 RibbonComponent。）
	ResumeLayout()	取消 SuspendLayout 方法的效果。（继承自 RibbonComponent。）
	ResumeLayout(Boolean)	取消 SuspendLayout 方法的效果。（继承自 RibbonComponent。）
	SuspendLayout	阻止 Microsoft Office 应用程序刷新功能区上的控件的状态。（继承自 RibbonComponent。）

页首

事件

	名称	说明
	ButtonClick	当用户单击 RibbonDropDown 上的按钮时发生。
	Disposed	表示处理组件的 Disposed 事件的方法。（继承自 IComponent。）
	ItemsLoading	在向 RibbonDropDown 中加载控件时发生。
	SelectionChanged	当用户在功能区下拉控件中选择新项时发生。

页首

备注

RibbonDropDown 可以包含 RibbonDropDownItem 对象和 RibbonButton 控件。

在运行时，可以使用 RibbonFactory 对象的 CreateRibbonDropDown 方法创建 RibbonDropDown。

有两种方法可访问 RibbonFactory 对象：

使用功能区类的 Factory 属性。请通过功能区类中的代码使用此方法。
使用 Globals.Factory.GetRibbonFactory 方法。请通过功能区类之外的代码使用此方法。

在功能区加载到 Office 之后，您不能在运行时向 Buttons 集合中添加按钮。

下面的过程解释如何将 RibbonDropDownItem 对象和 RibbonButton 控件添加到 RibbonDropDown。

在设计时添加 RibbonDropDownItem 对象

单击**“属性”窗口中的“Items”**属性。
单击省略号（“...”）。
在**“DropDown 集合编辑器”**中添加新项并对其进行排序和编辑。

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

在设计时添加 RibbonButton 控件

单击**“属性”窗口中的“Buttons”**属性。
单击省略号（“...”）。
在**“按钮集合编辑器”**中添加新按钮控件并对其进行排序和编辑。

此类型的某些成员只能在功能区加载到 Office 应用程序之前设置。有关如何设置这些属性的信息，请参见功能区对象模型概述。

备注

此接口由 Visual Studio Tools for Office Runtime 实现。不应在代码中实现此接口。有关更多信息，请参见 Visual Studio Tools for Office Runtime 概述。

用法

本文档介绍面向 .NET Framework 4 和 .NET Framework 4.5 的 Office 项目中所用此类型的版本。在面向 .NET Framework 3.5 的项目中，此类型可能具有不同的成员，因此本文档为此类型提供的代码示例可能并不适用。有关面向 .NET Framework 3.5 的项目中的此类型的文档，请参见 Visual Studio 2008 文档中的以下参考部分：https://go.microsoft.com/fwlink/?LinkId=160658。