Introducción a la cinta de opciones

La cinta de opciones es una manera de organizar los comandos relacionados para que sean más fáciles de encontrar. Los comandos aparecen como controles en la cinta de opciones. Los controles se organizan en grupos a lo largo de una franja horizontal en el borde superior de una ventana de la aplicación. Los grupos relacionados se organizan en pestañas.

La mayoría de las características a las que se accedió mediante menús y barras de herramientas en versiones anteriores del sistema de Microsoft Office ahora se pueden acceder mediante la cinta de opciones. Para obtener más información, consulte el artículo técnico Introducción al desarrollador de la interfaz de usuario para el sistema de Microsoft Office 2007.

Se aplica a: La información de este tema se aplica a proyectos de nivel de documento y proyectos de complementos de VSTO para las siguientes aplicaciones: Excel; InfoPath 2013 e InfoPath 2010; Outlook; PowerPoint; Project; Visio; Word. Para obtener más información, vea Características disponibles por aplicación de Office y tipo de proyecto.

Personalizar la cinta de Microsoft Office

Para personalizar la cinta de opciones, agregue uno de los siguientes elementos de la cinta de opciones al proyecto de Office:

• Cinta de opciones (Diseñador visual)

• Cinta de opciones (XML)

  Por ejemplo, para personalizar el Ribbon de Excel, agregue un elemento de Ribbon a un proyecto de complemento de VSTO para Excel.

Elemento de la cinta de opciones (Diseñador visual)

El elemento Cinta de opciones (Diseñador visual) proporciona herramientas avanzadas que facilitan el diseño y el desarrollo de una cinta de opciones personalizada. Use el elemento Cinta de opciones (Diseñador visual) para personalizar la cinta de opciones de las maneras siguientes:

• Agregue pestañas personalizadas o integradas a una cinta de opciones.

• Agregue grupos personalizados a una pestaña personalizada o integrada.

  Nota:

  Una pestaña o grupo integrado es una que ya existe en la cinta de opciones de una aplicación de Microsoft Office. Por ejemplo, la pestaña Datos es una pestaña integrada en Excel. El grupo Conexiones es un grupo integrado en la pestaña Datos .

• Agregue controles personalizados a un grupo personalizado.

• Agregue controles personalizados a la Vista Backstage.

  Para obtener más información sobre cómo personalizar una cinta de opciones mediante el elemento Cinta de opciones (Diseñador visual), consulte Diseñador de cintas de opciones.

Elemento de la cinta de opciones (XML)

Use el elemento Ribbon (XML) si desea personalizar la cinta de opciones de una manera que no sea compatible con el elemento Ribbon (Visual Designer). Use el elemento Cinta de opciones (XML) para personalizar la cinta de opciones de las maneras siguientes:

• Agregue grupos integrados a una pestaña personalizada o a una pestaña integrada.

• Agregue controles integrados a un grupo personalizado.

• Agregue código personalizado para invalidar los controladores de eventos de controles integrados.

• Personalice la barra de herramientas de acceso rápido.

• Comparta una personalización de la cinta de opciones entre el complemento VSTO mediante un identificador cualificado.

  Para obtener más información sobre cómo personalizar la cinta de opciones mediante el elemento Cinta de Opciones (XML), vea XML de la Cinta de Opciones.

Exportación de una cinta de opciones del Diseñador de cintas a XML de la cinta

Si crea una cinta de opciones mediante el Diseñador de cintas y, a continuación, decide que desea personalizar la cinta de opciones de maneras en que el elemento Cinta de opciones (Diseñador visual) no es compatible, puede exportar la cinta a XML.

Visual Studio crea automáticamente un elemento de cinta de opciones (XML) y rellena el archivo XML de la cinta de opciones con elementos y atributos para cada control de la cinta de opciones.

No todas las propiedades que se encuentran en la ventana Propiedades del Diseñador de cintas de opciones se transfieren al archivo XML de la cinta de opciones. Por ejemplo, Visual Studio no exporta el valor de la propiedad Image o Text . Esto se debe a que debe crear un método de devolución de llamada en el archivo de código del Ribbon del proyecto que se ha exportado para asignar una imagen o establecer el texto de un control. Visual Studio no genera automáticamente métodos de devolución de llamada como parte del proceso de exportación.

Además, los valores predeterminados de propiedad sin modificar no aparecen en el archivo XML de la Cinta de opciones resultante.

Para obtener más información sobre cómo exportar la cinta de opciones a XML, vea Cómo: Exportar una cinta de opciones desde el Diseñador de cintas a XML de la cinta de opciones.

Actualización del código

Se agrega un nuevo archivo de código Ribbon a Explorador de soluciones. Este archivo contiene la clase XML de la cinta de opciones. Debe crear callbacks en la región Ribbon Callbacks de esta clase para gestionar las acciones del usuario, como hacer clic en un botón. Mueva el código de los controladores de eventos a estos métodos de devolución de llamada y modifique el código para que funcione con el modelo de programación de extensibilidad de la cinta (RibbonX). Para obtener más información, consulte Ribbon XML.

También debe agregar código a la ThisAddIn, ThisWorkbook, o ThisDocument clase que sobrescribe el CreateRibbonExtensibilityObject método y devuelve la clase Ribbon XML a la aplicación de Office.

Para obtener más información, consulte Ribbon XML.

Agregar varios elementos de la cinta de opciones a un proyecto

Puede agregar más de un elemento de cinta a un solo proyecto. Esto resulta útil si desea realizar cualquiera de las dos tareas siguientes:

• Crear cintas para los Inspectores de Outlook. Para obtener más información, consulte Personalizar una cinta de opciones para Outlook.

  Nota:

  Un Inspector es una ventana que se abre cuando los usuarios realizan determinadas tareas, como crear un mensaje de correo electrónico.

• Seleccione la cinta de opciones que se va a mostrar en tiempo de ejecución.

Seleccionar las cintas de opciones que se van a mostrar en tiempo de ejecución

Dado que un proyecto puede contener más de una cinta de opciones, puede seleccionar qué cinta de opciones mostrar en tiempo de ejecución.

Para seleccionar una cinta de opciones que se va a mostrar en tiempo de ejecución, invalide el CreateRibbonExtensibilityObject método en la ThisAddinclase , ThisWorkbooko ThisDocument del proyecto y devuelva la cinta de opciones que desea mostrar. En el ejemplo siguiente se comprueba el valor de un campo denominado myCondition y se devuelve la cinta de opciones adecuada.

Agregue el código siguiente:

    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

Temas relacionados