RibbonFactory.CreateRibbonManager(IRibbonExtension[]) 方法

定义

命名空间:

Microsoft.Office.Tools.Ribbon

程序集:

Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll

创建表示功能区自定义项的 IRibbonExtensibility 对象。

public:
 Microsoft::Office::Core::IRibbonExtensibility ^ CreateRibbonManager(cli::array <Microsoft::Office::Tools::Ribbon::IRibbonExtension ^> ^ ribbons);

public Microsoft.Office.Core.IRibbonExtensibility CreateRibbonManager (Microsoft.Office.Tools.Ribbon.IRibbonExtension[] ribbons);

abstract member CreateRibbonManager : Microsoft.Office.Tools.Ribbon.IRibbonExtension[] -> Microsoft.Office.Core.IRibbonExtensibility

Public Function CreateRibbonManager (ribbons As IRibbonExtension()) As IRibbonExtensibility

参数

ribbons

IRibbonExtension[]

IRibbonExtension 实例的数组。

返回

IRibbonExtensibility

表示功能区自定义项的对象。

示例

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

注意

此示例中使用的语法返回使用功能区 (Visual Designer) 项创建的功能区。 返回使用 功能区 (XML) 项创建的功能区的 语法略有不同。 有关返回 功能区 (XML) 项的详细信息，请参阅 Ribbon XML。

    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() });
        }
    }

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

注解

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