RibbonFactory.CreateRibbonManager-Methode

Artikel
05/07/2013

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

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Syntax

'Declaration
Function CreateRibbonManager ( _
    ribbons As IRibbonExtension() _
) As IRibbonExtensibility

IRibbonExtensibility CreateRibbonManager(
    IRibbonExtension[] ribbons
)

Parameter

ribbons
Typ: array<Microsoft.Office.Tools.Ribbon.IRibbonExtension[]
Ein Array von IRibbonExtension-Instanzen.

Rückgabewert

Typ: Microsoft.Office.Core.IRibbonExtensibility
Ein Objekt, das eine Menübandanpassung darstellt.

Hinweise

Geben Sie das IRibbonExtensibility-Objekt in der CreateRibbonExtensibilityObject-Methode der ThisAddin-Klasse, der ThisWorkbook-Klasse oder der ThisDocument-Klasse des Projekts zurück, und geben Sie das anzuzeigende Menüband zurück, das in der Office-Anwendung angezeigt werden soll.

Beispiele

Das folgende Beispiel bestimmt mithilfe einer Bedingung, welches benutzerdefinierte Menüband angezeigt werden soll.In diesem Beispiel wird dann mit der CreateRibbonManager-Methode ein IRibbonExtension-Objekt erstellt und zurückgegeben, das das benutzerdefinierte Menüband darstellt.

Hinweis
Die in diesem Beispiel verwendete Syntax gibt ein Menüband zurück, das mithilfe des Elements Menüband (Visual Designer) erstellt wurde.Die Syntax für die Rückgabe eines Menübands, das mithilfe eines Elements vom Typ Menüband (XML) erstellt wird, weist einige kleine Unterschiede auf.Weitere Informationen zum Zurückgeben eines Elements vom Typ Menüband (XML) finden Sie unter Multifunktionsleisten-XML.

Die in diesem Beispiel verwendete Syntax gibt ein Menüband zurück, das mithilfe des Elements Menüband (Visual Designer) erstellt wurde.Die Syntax für die Rückgabe eines Menübands, das mithilfe eines Elements vom Typ Menüband (XML) erstellt wird, weist einige kleine Unterschiede auf.Weitere Informationen zum Zurückgeben eines Elements vom Typ Menüband (XML) finden Sie unter Multifunktionsleisten-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-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

RibbonFactory Schnittstelle

Microsoft.Office.Tools.Ribbon-Namespace

Freigeben über