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
)

參數

• ribbons
  型別：array<Microsoft.Office.Tools.Ribbon.IRibbonExtension[]
  IRibbonExtension 執行個體的陣列。

傳回值

型別：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 命名空間