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) 項目的詳細資訊，請參閱 功能區 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 應用程式中的功能區。