RibbonFactory.CreateRibbonManager(IRibbonExtension[]) Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Ribbon

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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt ein IRibbonExtensibility-Objekt, das eine Menübandanpassung darstellt.

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

Parameter

ribbons: IRibbonExtension[]

Ein Array von IRibbonExtension-Instanzen.

Gibt zurück

IRibbonExtensibility

Ein Objekt, das eine Menübandanpassung darstellt.

Beispiele

Im folgenden Beispiel wird eine Bedingung verwendet, um zu bestimmen, welches benutzerdefinierte Menüband angezeigt werden soll. In diesem Beispiel wird dann die CreateRibbonManager -Methode verwendet, um ein Objekt zu erstellen und dann zurückzugeben IRibbonExtension , das das benutzerdefinierte Menüband darstellt.

Hinweis

Die in diesem Beispiel verwendete Syntax gibt ein Menüband zurück, das mit dem Menübandelement (Visual Designer) erstellt wurde. Die Syntax für die Rückgabe eines Menübands, das mithilfe eines Menübandelements (XML) erstellt wird, unterscheidet sich geringfügig. Weitere Informationen zum Zurückgeben eines Menübandelements (XML) finden Sie unter Menüband-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

Hinweise

Geben Sie das IRibbonExtensibility -Objekt in der CreateRibbonExtensibilityObject -Methode der ThisAddin-, ThisWorkbook- oder ThisDocument -Klasse Ihres Projekts zurück, um das Menüband zurückzugeben, das Sie in der Office-Anwendung anzeigen möchten.

Gilt für:

Freigeben über