Microsoft.Office.Tools.Ribbon 命名空间

Microsoft.Office.Tools.Ribbon 命名空间包含组件、控件以及起支持作用的集合、类和枚举，可以使用它们来自定义多种 Microsoft Office 应用程序用户界面 (UI) 中的功能区。

Microsoft.Office.Tools.Ribbon 命名空间中的所有控件都可添加到 Office 自定义项中，方法是将它们从**“工具箱”的“Office 功能区控件”**选项卡拖入功能区设计器中。此外，RibbonMenu 控件可用来在运行时添加以下控件：

• RibbonButton

• RibbonCheckBox

• RibbonGallery

• RibbonMenu

• RibbonSeparator

• RibbonSplitButton

• RibbonToggleButton

若要在运行时将这些控件添加到 RibbonMenu，必须在设计时将该菜单的 Dynamic 属性设置为 true。

在运行时创建要添加到菜单的控件后，可以在将新创建的控件添加到菜单之前更改其任何属性。在将控件添加到菜单之后，其部分属性将变为只读。有关更多信息，请参见 功能区对象模型概述。

使用其他属性可以在运行时控制控件的外观和行为。例如，通过使用 Enabled 和 Visible 属性来启用、禁用、显示和隐藏在设计时添加的控件，可以实现对用户界面的运行时更改。

类

	类	说明
	RibbonBase	作为 Microsoft Office 功能区自定义项的基类。
	RibbonCollectionBase	提供对功能区自定义项中的 IRibbonExtension 对象的访问。

接口

	接口	说明
	IRibbonExtension	表示 OfficeRibbon 对象的一个扩展。
	OfficeRibbon	表示 Visual Studio 中通过使用 Office 项目中的功能区设计器创建的 Microsoft Office 功能区自定义项。
	RibbonBox	在自定义功能区上排列和对齐控件。
	RibbonButton	表示自定义功能区上的按钮。
	RibbonButtonGroup	表示功能区上的一组按钮控件。
	RibbonCheckBox	表示功能区上的复选框控件。
	RibbonComboBox	表示自定义功能区上的组合框。
	RibbonComponent	包含用于与 Visual Studio 通信、在应用程序中的控件层次结构中导航，以及优化控件的运行时布局的方法和成员。
	RibbonControl	提供 Microsoft Office 自定义项中的控件使用的属性。
	RibbonControlEventArgs	为 Microsoft Office 自定义项中引发的各种事件提供数据。
	RibbonControlId	封装 Microsoft Office 用来引用控件的标识字符串。
	RibbonDialogLauncher	表示组中可用来打开对话框的标准化小图标。
	RibbonDropDown	表示用户可以从中进行选择的项列表和用户可以单击的功能区按钮列表。
	RibbonDropDownItem	表示功能区下拉控件中下拉列表中的项。
	RibbonEditBox	表示功能区上的编辑框。
	RibbonFactory	提供可用于为 Microsoft Office 功能区自定义项创建功能区控件的方法。
	RibbonGallery	表示一个控件，该控件显示 RibbonDropDownItem 对象和 RibbonButton 控件的菜单。
	RibbonGroup	表示功能区选项卡上的一组控件。
	RibbonLabel	表示 RibbonGroup 或 RibbonBox 上的标签。
	RibbonLoadImageEventArgs	为 LoadImage 事件提供数据。
	RibbonManager	管理办公室项目中使用功能区设计器创建的功能区自定义设置。
	RibbonMenu	表示功能区选项卡上的菜单或 Microsoft Office 菜单上的菜单。
	RibbonOfficeMenu	提供对添加到 Microsoft Office 菜单的控件的访问。
	RibbonPosition	表示 Microsoft Office 菜单上的功能区控件相对于内置控件的位置、选项卡相对于内置选项卡的位置或者组相对于内置组的位置。
	RibbonPositionStatics	提供一些方法，用于指定功能区自定义项中的控件、组或选项卡的位置。
	RibbonReadOnlyCollection	提供对功能区自定义项中的 IRibbonExtension 对象的访问。
	RibbonSeparator	表示功能区上的组或菜单的分隔符控件。
	RibbonSplitButton	一个功能区控件，它将一个按钮或切换按钮与一个下拉菜单组合在一起。
	RibbonTab	包含功能区的一个或多个控件组。
	RibbonToggleButton	表示功能区上的一个切换按钮控件。
	RibbonUIEventArgs	为功能区中引发的事件提供数据。

委托

	委托	说明
	RibbonControlEventHandler	表示将处理 RibbonControl 的事件的方法。
	RibbonLoadImageEventHandler	表示将要处理 OfficeRibbon 的 LoadImage 事件的方法。
	RibbonUIEventHandler	表示将要处理 OfficeRibbon 的 Load 事件的方法。

枚举

	枚举	说明
	RibbonBoxStyle	指定控件在 RibbonBox 上垂直对齐还是水平对齐。
	RibbonButtonType	指定 RibbonSplitButton 所显示的按钮的类型。
	RibbonControlIdType	包含一些值，这些值确定 RibbonControlId 是标识 Microsoft Office 控件还是标识自定义控件。
	RibbonPositionType	指定控件在 Microsoft Office 菜单上的位置、一组控件在内置选项卡上的位置或者一个选项卡在一组内置或自定义选项卡中的位置。

请参见

参考

其他资源

功能区对象模型概述

功能区概述