DocumentBase.CreateRibbonExtensibilityObject Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.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.

Gibt ein Objekt zurück, das die Microsoft.Office.Core.IRibbonExtensibility-Schnittstelle implementiert.

protected:
 virtual Microsoft::Office::Core::IRibbonExtensibility ^ CreateRibbonExtensibilityObject();

protected virtual Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject ();

abstract member CreateRibbonExtensibilityObject : unit -> Microsoft.Office.Core.IRibbonExtensibility
override this.CreateRibbonExtensibilityObject : unit -> Microsoft.Office.Core.IRibbonExtensibility

Protected Overridable Function CreateRibbonExtensibilityObject () As IRibbonExtensibility

Gibt zurück

IRibbonExtensibility

Ein Objekt, das die Microsoft.Office.Core.IRibbonExtensibility-Schnittstelle implementiert.

Beispiele

Im folgenden Codebeispiel wird die -Methode in der CreateRibbonExtensibilityObjectThisAddin -Klasse oder ThisDocument des Projekts überschrieben und das Anzuzeigende Menüband zurückgegeben. Im Beispiel müssen Sie Ihrem Projekt zwei Menübänder mit dem Namen Ribbon1 und Ribbon2 mithilfe des Menübandelements (Visual Designer) hinzufügen. Im Beispiel wird der Wert eines Felds mit dem Namen myCondition überprüft und das entsprechende Menüband zurückgegeben. Um dieses Beispiel zu verwenden, führen Sie es in der ThisDocument -Klasse in einem Projekt auf Dokumentebene aus.

    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

Überschreiben Sie diese Methode, um eine Implementierung der Microsoft.Office.Core.IRibbonExtensibility Schnittstelle zurückzugeben. Wenn Ihr Projekt über mehrere Menübänder verfügt, können Sie angeben, welche Menübänder zur Laufzeit angezeigt werden sollen.

Sie müssen diese Methode nicht überschreiben, um Menübänder zurückzugeben, die Sie dem Projekt mithilfe der Elementvorlage Menüband (Visual Designer) hinzufügen. Standardmäßig gibt diese Methode ein RibbonManager Objekt zurück, das alle Menübandelemente (Visual Designer) im Projekt darstellt. Weitere Informationen finden Sie unter Übersicht über das Menüband.

Sie müssen die CreateRibbonExtensibilityObject -Methode oder RequestService überschreiben, um Menübänder in Ihrem Projekt zurückzugeben, die Sie mithilfe der Menübandelementvorlage (XML) hinzufügen. Weitere Informationen zum Überschreiben der CreateRibbonExtensibilityObject Methode finden Sie unter Menüband-XML.

Gilt für:

Freigeben über