DocumentBase.RequestService 方法
返回一个对象,该对象在文档级自定义项中实现 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 提供的几个接口(也称为“可扩展接口”)之一。但是,这是可以在 Word 的文档级自定义项中实现的唯一接口。您可以在应用程序级外接程序中实现其他扩展性接口。有关更多信息,请参见使用扩展性接口自定义 UI 功能。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。