RibbonFactory.CreateRibbonManager(IRibbonExtension[]) Methode

Definition

Erstellt ein IRibbonExtensibility-Objekt, das eine Menübandanpassung darstellt.Creates an IRibbonExtensibility object that represents a Ribbon customization.

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

Parameter

ribbons
IRibbonExtension[]

Ein Array von IRibbonExtension-Instanzen.An array of IRibbonExtension instances.

Gibt zurück

IRibbonExtensibility

Ein Objekt, das eine Menübandanpassung darstellt.An object that represents a Ribbon customization.

Beispiele

Im folgenden Beispiel wird eine Bedingung verwendet, um zu bestimmen, welches benutzerdefinierte Menüband angezeigt wird.The following example uses a condition to determine which custom Ribbon to display. In diesem Beispiel wird dann die CreateRibbonManager -Methode verwendet, um ein Objekt zu erstellen und zurückzugeben IRibbonExtension , das das benutzerdefinierte Menüband darstellt.This example then uses the CreateRibbonManager method to create and then return an IRibbonExtension object that represents the custom Ribbon.

Hinweis

Die in diesem Beispiel verwendete Syntax gibt eine Multifunktionsleiste zurück, die mit dem Element Menüband (visueller Designer) erstellt wurde.The syntax used in this example returns a Ribbon that was created by using the Ribbon (Visual Designer) item. Die Syntax zum Zurückgeben eines Menübands, das mit einem Menüband (XML) -Element erstellt wird, unterscheidet sich geringfügig.The syntax for returning a Ribbon that is created by using a Ribbon (XML) item is slightly different. Weitere Informationen zum Zurückgeben eines Elements im Menüband (XML) finden Sie unter Menüband-XML.For more information about returning a Ribbon (XML) item, see 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

Hinweise

Geben Sie das- IRibbonExtensibility Objekt in der- CreateRibbonExtensibilityObject Methode der- ThisAddin ,-oder-Klasse Ihres ThisWorkbook Projekts zurück ThisDocument , um das Menüband zurückzugeben, das Sie in der Office-Anwendung anzeigen möchten.Return the IRibbonExtensibility object in the CreateRibbonExtensibilityObject method of the ThisAddin, ThisWorkbook, or ThisDocument class of your project to return the Ribbon that you want to display in the Office application.

Gilt für: