DocumentBase.RequestService(Guid) Methode

Definition

Gibt ein Objekt zurück, das die Microsoft.Office.Core.IRibbonExtensibility-Schnittstelle in einer Anpassung auf Dokumentebene implementiert.

protected:
 virtual System::Object ^ RequestService(Guid serviceGuid);
protected virtual object RequestService (Guid serviceGuid);
abstract member RequestService : Guid -> obj
override this.RequestService : Guid -> obj
Protected Overridable Function RequestService (serviceGuid As Guid) As Object

Parameter

serviceGuid
Guid

Eine Guid, mit der die Microsoft.Office.Core.IRibbonExtensibility-Schnittstelle identifiziert wird.

Gibt zurück

Ein Objekt in der Anpassung auf Dokumentebene, das die Microsoft.Office.Core.IRibbonExtensibility-Schnittstelle implementiert.

Hinweise

Überschreiben Sie diese Methode, wenn Sie das Menüband des Dokuments anpassen, indem Sie Eine eigene Implementierung der Microsoft.Office.Core.IRibbonExtensibility Schnittstelle erstellen oder dem Projekt ein Menübandelement (XML) hinzufügen.

Wenn Sie das Menüband anpassen, indem Sie Ihrem Projekt ein Menübandelement (Visual Designer) hinzufügen, überschreibt Visual Studio diese Methode für Sie. Weitere Informationen finden Sie unter Übersicht über das Menüband und menüband Designer.

Wenn Sie diese Methode überschreiben, überprüfen Sie den Wert des serviceGuid Parameters, um zu bestimmen, ob die Microsoft.Office.Core.IRibbonExtensibility Schnittstelle angefordert wird, und geben Sie dann ein Objekt zurück, das die Schnittstelle implementiert. Wenn Ihr Dokument geöffnet wird, ruft die Visual Studio-Tools für Office Runtime auf RequestServiceund sendet den Rückgabewert an Microsoft Office Word. Weitere Informationen zur Microsoft.Office.Core.IRibbonExtensibility Schnittstelle finden Sie unter IRibbonExtensibility Object in der Microsoft Office-Dokumentation.

Alternativ können Sie die CreateRibbonExtensibilityObject -Methode überschreiben, anstatt die RequestService -Methode zu überschreiben. Weitere Informationen finden Sie unter Ribbon XML.

Hinweis

Microsoft.Office.Core.IRibbonExtensibility ist eine von mehreren Schnittstellen (auch als Erweiterbarkeitsschnittstellen bezeichnet), die von Microsoft Office bereitgestellt werden. Dies ist jedoch die einzige Schnittstelle, die Sie in einer Anpassung auf Dokumentebene für Word implementieren können. Sie können andere Erweiterbarkeitsschnittstellen in Add-Ins auf Anwendungsebene implementieren. Weitere Informationen finden Sie unter Anpassen von Ui-Features mithilfe von Erweiterbarkeitsschnittstellen.

Gilt für: