Поделиться через


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
    Объект Guid, определяющий интерфейс Microsoft.Office.Core.IRibbonExtensibility.

Возвращаемое значение

Тип: System.Object
Объект в настройке уровня документа, реализующий интерфейс Microsoft.Office.Core.IRibbonExtensibility.

Заметки

При настройке ленты документа путем создания собственной реализации интерфейса Microsoft.Office.Core.IRibbonExtensibility или путем добавления элемента Ribbon (XML) в проект, необходимо переопределить этот метод.

При настройке ленты путем добавления элемента Ribbon (Visual Designer) в проект Visual Studio самостоятельно выполнит переопределение этого метода. Дополнительные сведения см. в разделах Обзор ленты и Конструктор лент.

При переопределении этого метода следует проверить значение параметра serviceGuid, чтобы определить, был ли запрошен интерфейс Microsoft.Office.Core.IRibbonExtensibility, а затем вернуть объект, который реализует этот интерфейс. Когда открыт документ, Среда выполнения Visual Studio Tools for Office вызывает метод RequestService и он отправляет возвращаемое значение в Microsoft Office Word. Дополнительные сведения об интерфейсе Microsoft.Office.Core.IRibbonExtensibility см. в разделе Объект IRibbonExtensibility документации по Microsoft Office.

Кроме того, можно переопределить метод CreateRibbonExtensibilityObject вместо метода RequestService. Дополнительные сведения см. в разделе XML-ленты.

Примечание

Интерфейс Microsoft.Office.Core.IRibbonExtensibility — это один из нескольких интерфейсов (также называемых интерфейсами расширения), которые предоставляются системой Microsoft Office.Однако это единственный интерфейс, который можно реализовать в настройке уровня документа для Word.Можно реализовать другие интерфейсы расширения в надстройках уровня приложения.Дополнительные сведения см. в разделе Настройка функций пользовательского интерфейса с помощью интерфейсов расширяемости.

Безопасность платформы .NET Framework

См. также

Ссылки

DocumentBase Класс

Microsoft.Office.Tools.Word - пространство имен