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 安全性

请参见

参考

DocumentBase 类

Microsoft.Office.Tools.Word 命名空间