RibbonFactory.CreateRibbonManager(IRibbonExtension[]) Метод

Определение

Пространство имен:

Microsoft.Office.Tools.Ribbon

Сборки:

Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll

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

public:
 Microsoft::Office::Core::IRibbonExtensibility ^ CreateRibbonManager(cli::array <Microsoft::Office::Tools::Ribbon::IRibbonExtension ^> ^ ribbons);

public Microsoft.Office.Core.IRibbonExtensibility CreateRibbonManager (Microsoft.Office.Tools.Ribbon.IRibbonExtension[] ribbons);

abstract member CreateRibbonManager : Microsoft.Office.Tools.Ribbon.IRibbonExtension[] -> Microsoft.Office.Core.IRibbonExtensibility

Public Function CreateRibbonManager (ribbons As IRibbonExtension()) As IRibbonExtensibility

Параметры

ribbons

IRibbonExtension[]

Массив экземпляров IRibbonExtension.

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

IRibbonExtensibility

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

Примеры

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

Примечание

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

    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() });
        }
    }

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

Комментарии

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