DocumentBase.CreateRibbonExtensibilityObject-Methode
Gibt ein Objekt zurück, das die Microsoft.Office.Core.IRibbonExtensibility-Schnittstelle implementiert.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Syntax
'Declaration
Protected Overridable Function CreateRibbonExtensibilityObject As IRibbonExtensibility
protected virtual IRibbonExtensibility CreateRibbonExtensibilityObject()
Rückgabewert
Typ: Microsoft.Office.Core.IRibbonExtensibility
Ein Objekt, das die Microsoft.Office.Core.IRibbonExtensibility-Schnittstelle implementiert.
Hinweise
Überschreiben Sie diese Methode, um eine Implementierung der Microsoft.Office.Core.IRibbonExtensibility-Schnittstelle zurückzugeben. Sollten Sie in Ihrem Projekt über mehrere Menübänder verfügen, können Sie das während der Laufzeit anzuzeigende Menüband angeben.
Diese Methode muss nicht überschrieben werden, um die Menübänder zurückzugeben, die dem Projekt mithilfe der Elementvorlage Menüband (Visual Designer) hinzugefügt werden. Standardmäßig wird mit dieser Methode ein RibbonManager-Objekt zurückgegeben, das alle Elemente von Menüband (Visual Designer) im Projekt darstellt. Weitere Informationen finden Sie unter Übersicht über die Multifunktionsleiste.
Die CreateRibbonExtensibilityObject-Methode oder die RequestService-Methode muss überschrieben werden, um Menübänder im Projekt zurückzugeben, die mithilfe der Elementvorlage Menüband (XML) hinzugefügt werden. Weitere Informationen zum Überschreiben der CreateRibbonExtensibilityObject-Methode finden Sie unter Multifunktionsleisten-XML.
Beispiele
Im folgenden Codebeispiel wird die CreateRibbonExtensibilityObject-Methode in der ThisAddin-Klasse oder in der ThisDocument-Klasse des Projekts überschrieben, und das anzuzeigende Menüband wird zurückgegeben. Für dieses Beispiel müssen dem Projekt zwei Menübänder mit den Namen Ribbon1 und Ribbon2 hinzugefügt werden. Verwenden Sie hierfür das Element Menüband (Visual Designer). Der Wert eines Felds mit der Bezeichnung myCondition wird überprüft, und das entsprechende Menüband wird zurückgegeben. Wenn Sie dieses Beispiel verwenden möchten, führen Sie es von der ThisDocument-Klasse in einem Projekt auf Dokumentebene aus.
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.