Share via


RibbonFactory.CreateRibbonManager(IRibbonExtension[]) Método

Definición

Crea un objeto IRibbonExtensibility que representa una personalización de la cinta.

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

Parámetros

ribbons
IRibbonExtension[]

Matriz de instancias de IRibbonExtension.

Devoluciones

Objeto que representa una personalización de la cinta.

Ejemplos

En el ejemplo siguiente se usa una condición para determinar qué cinta personalizada se va a mostrar. A continuación, en este ejemplo se usa el CreateRibbonManager método para crear y, a continuación, devolver un IRibbonExtension objeto que representa la cinta personalizada.

Nota

La sintaxis usada en este ejemplo devuelve una cinta que se creó mediante el elemento Ribbon (Visual Designer). La sintaxis para devolver una cinta de opciones que se crea mediante un elemento de cinta de opciones (XML) es ligeramente diferente. Para obtener más información sobre cómo devolver un elemento de cinta de opciones (XML), vea XML de la cinta de opciones.

    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

Comentarios

Devuelve el IRibbonExtensibility objeto en el CreateRibbonExtensibilityObject método de la ThisAddinclase , ThisWorkbooko ThisDocument del proyecto para devolver la cinta de opciones que desea mostrar en la aplicación de Office.

Se aplica a