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

Определение

Создает объект IRibbonExtensibility, представляющий пользовательские настройки ленты.Creates an IRibbonExtensibility object that represents a Ribbon customization.

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

Параметры

ribbons
IRibbonExtension[]

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

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

IRibbonExtensibility

Объект, представляющий настройку ленты.An object that represents a Ribbon customization.

Примеры

В следующем примере используется условие, чтобы определить, какая пользовательская лента должна отображаться.The following example uses a condition to determine which custom Ribbon to display. В этом примере используется CreateRibbonManager метод для создания и возврата IRibbonExtension объекта, представляющего пользовательскую ленту.This example then uses the CreateRibbonManager method to create and then return an IRibbonExtension object that represents the custom Ribbon.

Примечание

Синтаксис, используемый в этом примере, возвращает ленту, созданную с помощью элемента Лента (визуальный конструктор) .The syntax used in this example returns a Ribbon that was created by using the Ribbon (Visual Designer) item. Синтаксис возврата ленты, созданной с помощью элемента ленты (XML) , немного отличается.The syntax for returning a Ribbon that is created by using a Ribbon (XML) item is slightly different. Дополнительные сведения о возврате элемента ленты (XML) см. в разделе Ribbon XML.For more information about returning a Ribbon (XML) item, see Ribbon 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.Return the IRibbonExtensibility object in the CreateRibbonExtensibilityObject method of the ThisAddin, ThisWorkbook, or ThisDocument class of your project to return the Ribbon that you want to display in the Office application.

Применяется к