DocumentBase.CreateRibbonExtensibilityObject Método

Referencia

Definición

Espacio de nombres:: Microsoft.Office.Tools.Word

Ensamblado:: Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

IRibbonExtensibility

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

Share via