RibbonFactory.CreateRibbonManager 方法

创建一个 IRibbonExtensibility 对象,该对象表示一个功能区自定义项。

命名空间:  Microsoft.Office.Tools.Ribbon
程序集:  Microsoft.Office.Tools.Common(在 Microsoft.Office.Tools.Common.dll 中)

语法

声明
Function CreateRibbonManager ( _
    ribbons As IRibbonExtension() _
) As IRibbonExtensibility
IRibbonExtensibility CreateRibbonManager(
    IRibbonExtension[] ribbons
)

参数

返回值

类型:Microsoft.Office.Core.IRibbonExtensibility
一个表示功能区自定义项的对象。

备注

返回项目的 ThisAddin、ThisWorkbook 或 ThisDocument 类的 CreateRibbonExtensibilityObject 方法中的 IRibbonExtensibility 对象,以返回您希望在 Office 应用程序中显示的功能区。

示例

下面的示例使用一个条件来确定要显示哪些自定义功能区。此示例然后使用 CreateRibbonManager 方法创建并返回表示自定义功能区的 IRibbonExtension 对象。

说明说明

此示例中使用的语法返回使用“功能区(可视化设计器)”项创建的功能区。用于返回使用“功能区(XML)”项创建的功能区的语法稍有不同。有关返回“功能区(XML)”项的更多信息,请参见功能区 XML

Protected Overrides Function CreateRibbonExtensibilityObject() As  _
    Microsoft.Office.Core.IRibbonExtensibility
    If myCondition = True Then
        Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
                 {New Ribbon1()})
    Else
        Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
                 {New Ribbon2()})
    End If
End Function
    protected override Microsoft.Office.Core.IRibbonExtensibility
CreateRibbonExtensibilityObject()
    {
        if (myCondition == true)
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon1() });
        }
        else
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon2() });
        }
    }

.NET Framework 安全性

请参见

参考

RibbonFactory 接口

Microsoft.Office.Tools.Ribbon 命名空间