RibbonFactory.CreateRibbonManager - метод

Статья
05/19/2013

Создает объект IRibbonExtensibility, представляющий настройку ленты.

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

Синтаксис

'Декларация
Function CreateRibbonManager ( _
    ribbons As IRibbonExtension() _
) As IRibbonExtensibility

IRibbonExtensibility CreateRibbonManager(
    IRibbonExtension[] ribbons
)

Параметры

ribbons
Тип: array<Microsoft.Office.Tools.Ribbon.IRibbonExtension[]
Массив экземпляров класса IRibbonExtension.

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

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

Заметки

Верните объект IRibbonExtensibility в методе CreateRibbonExtensibilityObject класса ThisAddin, ThisWorkbook или ThisDocument вашего проекта, чтобы вернуть ленту, которую требуется отобразить в приложении Office.

Примеры

В следующем примере используется условие, определяющее, какую настраиваемую ленту следует отобразить.В этом примере метод CreateRibbonManager используется для создания и последующего возвращения объекта IRibbonExtension, представляющего пользовательскую ленту.

Примечание
Синтаксис, используемый в данном примере, возвращает ленту, созданную с помощью элемента Лента (визуальный конструктор).Синтаксис, возвращающий ленту, созданную с помощью элемента Лента (XML), отличается незначительно.Дополнительные сведения о возврате элемента Лента (XML) см. в разделе XML-ленты.

Синтаксис, используемый в данном примере, возвращает ленту, созданную с помощью элемента Лента (визуальный конструктор).Синтаксис, возвращающий ленту, созданную с помощью элемента Лента (XML), отличается незначительно.Дополнительные сведения о возврате элемента Лента (XML) см. в разделе XML-ленты.

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

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

См. также

Ссылки

RibbonFactory Интерфейс

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

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