DocumentBase.CreateRibbonExtensibilityObject - метод

Статья
08/11/2011

Возвращает объект, который реализует интерфейс 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 CreateRibbonExtensibilityObject As IRibbonExtensibility

protected virtual IRibbonExtensibility CreateRibbonExtensibilityObject()

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

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

Заметки

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

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

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

Примеры

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

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

    protected override Microsoft.Office.Core.IRibbonExtensibility
CreateRibbonExtensibilityObject()
    {
        if (myCondition == true)
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon1() });
        }
        else
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon2() });
        }
    }

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

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

См. также

Ссылки

DocumentBase Класс

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

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