DocumentBase.RequestService 方法

發行項
08/12/2011

傳回物件，這個物件會實作文件層級自訂中的 Microsoft.Office.Core.IRibbonExtensibility 介面。

命名空間： Microsoft.Office.Tools.Word
組件： Microsoft.Office.Tools.Word.v4.0.Utilities (在 Microsoft.Office.Tools.Word.v4.0.Utilities.dll 中)

語法

'宣告
Protected Overridable Function RequestService ( _
    serviceGuid As Guid _
) As Object

protected virtual Object RequestService(
    Guid serviceGuid
)

參數

serviceGuid
型別：System.Guid
可識別 Microsoft.Office.Core.IRibbonExtensibility 介面的 Guid。

傳回值

型別：System.Object
文件層級自訂中的物件，這個物件會實作 Microsoft.Office.Core.IRibbonExtensibility 介面。

備註

如果您要建立自己的 Microsoft.Office.Core.IRibbonExtensibility 介面實作，或將 [功能區 (XML)] 項目加入至專案，以自訂文件的功能區，請覆寫這個方法。

如果您將 [功能區 (視覺化設計工具)] 項目加入至專案以自訂功能區，Visual Studio 就會為您覆寫這個方法。如需詳細資訊，請參閱功能區概觀和功能區設計工具。

如果您覆寫這個方法，請檢查 serviceGuid 參數值以判斷是否正在要求 Microsoft.Office.Core.IRibbonExtensibility 介面，然後傳回實作該介面的物件。當您的文件開啟時，Visual Studio Tools for Office Runtime 會呼叫 RequestService，然後將傳回值傳送至 Microsoft Office Word。如需 Microsoft.Office.Core.IRibbonExtensibility 介面的詳細資訊，請參閱 Microsoft Office 文件中的 IRibbonExtensibility 物件。

或者，您也可以覆寫 CreateRibbonExtensibilityObject 方法，而不覆寫 RequestService 方法。如需詳細資訊，請參閱功能區 XML。

注意事項
Microsoft.Office.Core.IRibbonExtensibility 是 Microsoft Office 所提供數個介面 (又稱「擴充性介面」(Extensibility Interface)) 的其中一個介面。不過，這是唯一可以在 Word 的文件層級自訂中實作的介面。您可以在應用程式層級增益集中實作其他擴充性介面。如需詳細資訊，請參閱使用擴充性介面自訂 UI 功能。