DocumentBase.RequestService(Guid) 方法

定义

返回在文档级自定义项中实现 Microsoft.Office.Core.IRibbonExtensibility 接口的对象。

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

参数

serviceGuid
Guid

一个标识 Microsoft.Office.Core.IRibbonExtensibility 接口的 Guid

返回

文档级自定义项中实现 Microsoft.Office.Core.IRibbonExtensibility 接口的对象。

注解

如果要通过创建自己的接口实现 Microsoft.Office.Core.IRibbonExtensibility 或通过向项目添加 功能区 (XML) 项来自定义文档的功能区,请重写此方法。

如果通过将功能区 (Visual Designer) 项添加到项目来自定义功能区,Visual Studio 将替代此方法。 有关详细信息,请参阅功能区概述功能区Designer

如果重写此方法,检查 参数的值serviceGuid以确定是否Microsoft.Office.Core.IRibbonExtensibility正在请求接口,然后返回实现接口的对象。 打开文档时,Visual Studio Tools for Office运行时调用 RequestService,并将返回值发送到 Microsoft Office Word。 有关 接口的详细信息 Microsoft.Office.Core.IRibbonExtensibility ,请参阅 Microsoft Office 文档中的 IRibbonExtensibility 对象

或者,可以重写 方法, CreateRibbonExtensibilityObject 而不是重写 RequestService 方法。 有关更多信息,请参见 Ribbon XML

注意

Microsoft.Office.Core.IRibbonExtensibility 是 Microsoft Office 提供的多个接口 (也命名为 扩展性接口) 之一。 但是,这是唯一可以在文档级自定义中为Word实现的接口。 可以在应用程序级外接程序中实现其他扩展性接口。有关详细信息,请参阅 使用扩展性接口自定义 UI 功能

适用于