Document.CreateRibbonExtensibilityObject Метод (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 CreateRibbonExtensibilityObject As IRibbonExtensibility
'Применение
Dim returnValue As IRibbonExtensibility

returnValue = Me.CreateRibbonExtensibilityObject()

protected virtual IRibbonExtensibility CreateRibbonExtensibilityObject()

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

Тип: Microsoft.Office.Core.IRibbonExtensibility
Объект, реализующий интерфейс Microsoft.Office.Core.IRibbonExtensibility.

Заметки

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

Не обязательно переопределять этот метод для возврата лент, добавленных в проект с помощью шаблона элемента Ribbon (Visual Designer). По умолчанию этот метод возвращает объект RibbonManager, представляющий все элементы Лента (визуальный конструктор) в проекте. Дополнительные сведения см. в разделе Обзор ленты.

Для возврата лент, добавленных в проект с помощью шаблона элемента Ribbon (XML), необходимо переопределить метод CreateRibbonExtensibilityObject или RequestService. Дополнительные сведения о порядке переопределения метода CreateRibbonExtensibilityObject см. в разделе XML-ленты.

Примеры

В приведенном ниже примере кода переопределяется метод CreateRibbonExtensibilityObject в классе проекта ThisAddin или ThisDocument и возвращается лента, которую требуется отобразить. В данном примере требуется добавить в проект с помощью элемента Лента (визуальный конструктор) две ленты с именами Ribbon1 и Ribbon2. В примере проверяется значение поля myCondition и возвращается соответствующая лента.

В этом примере демонстрируется настройка уровня документа.

Protected Overrides Function CreateRibbonExtensibilityObject() As  _
    Microsoft.Office.Core.IRibbonExtensibility
    If myCondition = True Then
        Return New Microsoft.Office.Tools.Ribbon.RibbonManager _
            (New Microsoft.Office.Tools.Ribbon.OfficeRibbon() _
                 {New Ribbon1()})
    Else
        Return New Microsoft.Office.Tools.Ribbon.RibbonManager _
            (New Microsoft.Office.Tools.Ribbon.OfficeRibbon() _
                {New Ribbon2()})
    End If
End Function

    protected override Microsoft.Office.Core.IRibbonExtensibility
CreateRibbonExtensibilityObject()
    {
        if (myCondition == true)
        {
            return new Microsoft.Office.Tools.Ribbon.RibbonManager(
                new Microsoft.Office.Tools.Ribbon.OfficeRibbon[] 
                    { new Ribbon1() });
        }
        else
        {
            return new Microsoft.Office.Tools.Ribbon.RibbonManager(
                new Microsoft.Office.Tools.Ribbon.OfficeRibbon[] 
                    { new Ribbon2() });
        }
    }

Разрешения

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

См. также

Ссылки

Document Класс

Document - члены

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

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