RibbonFactory 接口

提供可用于为 Microsoft Office 功能区自定义项创建功能区控件的方法。

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

语法

声明
<GuidAttribute("1012BDD2-303F-4464-A64B-3026BD91C31E")> _
<InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)> _
Public Interface RibbonFactory

[GuidAttribute("1012BDD2-303F-4464-A64B-3026BD91C31E")]
[InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)]
public interface RibbonFactory

RibbonFactory 类型公开以下成员。

属性

	名称	说明
	RibbonPosition	获取一个 RibbonPositionStatics 对象，该对象可用于指定功能区自定义项中控件、组或选项卡的位置。

页首

方法

	名称	说明
	_VtblGap1_19
	CreateOfficeRibbon	创建一个 OfficeRibbon 对象，该对象表示一个功能区自定义项。
	CreateRibbonBox	创建一个 RibbonBox 对象，该对象会排列和对齐自定义功能区上的控件。
	CreateRibbonButton	一个 RibbonButton，该对象表示自定义功能区上的一个按钮。
	CreateRibbonButtonGroup	创建一个 RibbonButtonGroup 对象，该对象表示功能区上的一组按钮。
	CreateRibbonCheckBox	创建一个 RibbonCheckBox 对象，该对象表示功能区上的一个复选框。
	CreateRibbonComboBox	创建一个 RibbonComboBox 对象，该对象表示自定义功能区上的一个组合框。
	CreateRibbonDialogLauncher	创建一个 RibbonDialogLauncher 对象，该对象表示组上可用于打开对话框的一个标准化小图标。
	CreateRibbonDropDown	创建一个 RibbonDropDown 对象，该对象表示用户可以从中选择的项列表和用户可以单击的功能区按钮列表。
	CreateRibbonDropDownItem	创建一个 RibbonDropDownItem 对象，该对象表示下拉控件中的一个项。
	CreateRibbonEditBox	创建一个 RibbonEditBox 对象，该对象表示功能区上的一个编辑框。
	CreateRibbonGallery	创建一个 RibbonGallery 对象，该对象表示会显示 RibbonDropDownItem 对象和 RibbonButton 控件的菜单的一个控件。
	CreateRibbonGroup	创建一个 RibbonGroup 对象，该对象表示功能区选项卡上的一组控件。
	CreateRibbonLabel	创建一个 RibbonLabel，该对象表示 RibbonGroup 或 RibbonBox 上的一个标签。
	CreateRibbonManager	创建一个 IRibbonExtensibility 对象，该对象表示一个功能区自定义项。
	CreateRibbonMenu	创建一个 RibbonMenu，该对象表示功能区选项卡或 Microsoft Office 菜单上的一个菜单。
	CreateRibbonReadOnlyCollection	创建一个 RibbonMenu 对象，该对象提供对功能区自定义项中的 IRibbonExtension 对象的访问。
	CreateRibbonSeparator	创建一个 RibbonSeparator 对象，该对象表示功能区上的组或菜单的分隔符控件。
	CreateRibbonSplitButton	创建一个 RibbonSplitButton 对象，该对象将一个按钮或切换按钮与一个下拉菜单组合在一起。
	CreateRibbonTab	创建一个 RibbonTab 对象，该对象包含功能区的一个或多个控件组。
	CreateRibbonToggleButton	创建一个 RibbonToggleButton，该对象表示功能区上的一个切换按钮控件。

页首

备注

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

示例

下面的示例访问 Excel 2010 工作薄项目的功能区代码文件中的项目的 RibbonFactory 实例。此代码使用 RibbonFactory 对象中的方法来创建下拉项、菜单和按钮。若要查看完整示例，请参见演练：在运行时更新功能区上的控件。

Private Function CreateRibbonDropDownItem() As RibbonDropDownItem
    Return Me.Factory.CreateRibbonDropDownItem()
End Function

Private Function CreateRibbonMenu() As RibbonMenu
    Return Me.Factory.CreateRibbonMenu()
End Function

Private Function CreateRibbonButton() As RibbonButton
    Dim button As RibbonButton = Me.Factory.CreateRibbonButton()
    AddHandler (button.Click), AddressOf Button_Click
    Return button
End Function

private RibbonDropDownItem CreateRibbonDropDownItem()
{
    return this.Factory.CreateRibbonDropDownItem();
}
private RibbonMenu CreateRibbonMenu()
{
    return this.Factory.CreateRibbonMenu();
}
private RibbonButton CreateRibbonButton()
{
    RibbonButton button = this.Factory.CreateRibbonButton();
    button.Click += new RibbonControlEventHandler(button_Click);
    return button;
}

请参见

参考

Microsoft.Office.Tools.Ribbon 命名空间