Compartir a través de


DocumentBase.CreateRibbonExtensibilityObject Método

Definición

Devuelve un objeto que implementa la interfaz Microsoft.Office.Core.IRibbonExtensibility.

protected:
 virtual Microsoft::Office::Core::IRibbonExtensibility ^ CreateRibbonExtensibilityObject();
protected virtual Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject ();
abstract member CreateRibbonExtensibilityObject : unit -> Microsoft.Office.Core.IRibbonExtensibility
override this.CreateRibbonExtensibilityObject : unit -> Microsoft.Office.Core.IRibbonExtensibility
Protected Overridable Function CreateRibbonExtensibilityObject () As IRibbonExtensibility

Devoluciones

Objeto que implementa la interfaz Microsoft.Office.Core.IRibbonExtensibility.

Ejemplos

En el ejemplo de código siguiente se invalida el CreateRibbonExtensibilityObject método en la ThisAddin clase o ThisDocument del proyecto y se devuelve la cinta de opciones que desea mostrar. El ejemplo requiere que se agreguen dos cintas de opciones al proyecto llamado Ribbon1 y Ribbon2 mediante el elemento Ribbon (Visual Designer). En el ejemplo se comprueba el valor de un campo denominado myCondition y se devuelve la cinta de opciones adecuada. Para usar este ejemplo, ejecútelo desde la ThisDocument clase en un proyecto de nivel de documento.

    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

Invalide este método para devolver una implementación de la Microsoft.Office.Core.IRibbonExtensibility interfaz. Si tiene varias cintas de opciones en el proyecto, puede especificar qué cintas se mostrarán en tiempo de ejecución.

No es necesario invalidar este método para devolver cintas de opciones que agregue al proyecto mediante la plantilla de elemento Cinta de opciones (Visual Designer). De forma predeterminada, este método devuelve un RibbonManager objeto que representa todos los elementos de cinta de opciones (Visual Designer) del proyecto. Para obtener más información, vea Información general de la cinta de opciones.

Debe invalidar el CreateRibbonExtensibilityObject método o RequestService para devolver cintas de opciones en el proyecto que agregue mediante la plantilla de elemento cinta de opciones (XML ). Para obtener más información sobre cómo invalidar el CreateRibbonExtensibilityObject método, vea XML de la cinta de opciones.

Se aplica a