Document.RequestService Метод (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

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

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)

Синтаксис

'Декларация
Protected Overridable Function RequestService ( _
    serviceGuid As Guid _
) As Object
'Применение
Dim serviceGuid As Guid
Dim returnValue As Object

returnValue = Me.RequestService(serviceGuid)

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 Tools for Office самостоятельно выполнит переопределение этого метода. Дополнительные сведения см. в разделах Обзор ленты и Конструктор лент.

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

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

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

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

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

Document Класс

Document - члены

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

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