RibbonFactory.CreateRibbonManager (Método)

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

Espacio de nombres:  Microsoft.Office.Tools.Ribbon
Ensamblado:  Microsoft.Office.Tools.Common (en Microsoft.Office.Tools.Common.dll)

Sintaxis

'Declaración
Function CreateRibbonManager ( _
    ribbons As IRibbonExtension() _
) As IRibbonExtensibility

IRibbonExtensibility CreateRibbonManager(
    IRibbonExtension[] ribbons
)

Parámetros

• ribbons
  Tipo: array<Microsoft.Office.Tools.Ribbon.IRibbonExtension[]
  Matriz de instancias de IRibbonExtension.

Valor devuelto

Tipo: Microsoft.Office.Core.IRibbonExtensibility
Objeto que representa una personalización de la cinta.

Comentarios

Devolución del objeto IRibbonExtensibility en el método CreateRibbonExtensibilityObject de la clase ThisAddin, ThisWorkbook o ThisDocument de su proyecto para volver a la Cinta que desea mostrar en la aplicación de Office.

Ejemplos

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

[!NOTA]

La sintaxis utilizada en este ejemplo devuelve una cinta de opciones creada con el elemento Cinta (diseñador visual).La sintaxis para devolver una cinta que se crea con un elemento Cinta (XML) es ligeramente diferente.Para obtener más información sobre cómo devolver un elemento Cinta (XML), vea XML de la cinta de opciones.

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

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

RibbonFactory Interfaz

Microsoft.Office.Tools.Ribbon (Espacio de nombres)