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; Proyecto; Visio; Palabra. Para obtener más información, consulte Características disponibles por aplicación de Office lication 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 la cinta de Excel, agregue un elemento de cinta a un proyecto de complemento de Excel de VSTO.

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 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 Office lication de Microsoft. Por ejemplo, la pestaña Datos es una pestaña integrada en Excel. El grupo Conectar ions 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 mediante el elemento Cinta de opciones (Diseñador visual), vea 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 los controles integrados.

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

• Comparta una personalización de cinta entre el complemento de VSTO usando un identificador calificado.

  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 se transfieren al archivo XML de la cinta de opciones. Por ejemplo, Visual Studio no exporta el valor de la propiedad Image o Text . Eso es porque debe crear un método de devolución de llamada en el archivo de código de la cinta del proyecto 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 de propiedad predeterminados sin modificar no aparecen en el archivo XML de la cinta 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 de la cinta de opciones a Explorador de soluciones. Este archivo contiene la clase XML de la cinta. Debe crear métodos de devolución de llamada en la región Ribbon Callbacks de esta clase para controlar las acciones del usuario, como es el 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, consulta Ribbon XML.

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

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

Agregar varios elementos de la cinta de opciones a un proyecto

Puede agregar más de un elemento de cinta a un mismo proyecto. Esto resulta útil si desea realizar alguna de las dos tareas indicadas a continuación:

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

  Nota:

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

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

Selección de 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 se va a 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.

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 ribbon (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.

Agregue el siguiente código:

C#

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

VB

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

Title	Descripción
Cómo: Introducción a la personalización de la cinta	Muestra cómo personalizar la cinta de opciones de una aplicación de Office lication de Microsoft, agregar un elemento Ribbon (Visual Designer) o Ribbon (XML) a un proyecto de Office.
Diseñador de la cinta de opciones	Describe cómo puede usar el Diseñador de cintas de opciones para agregar pestañas, grupos y controles personalizados a la cinta de opciones de una aplicación de Office lication de Microsoft.
Tutorial: Creación de una pestaña personalizada mediante el Diseñador de cintas	Muestra cómo crear una pestaña personalizada de la cinta mediante el diseñador de la cinta. Puede usar el diseñador de la cinta para agregar y colocar controles en la pestaña personalizada.
Introducción al modelo de objetos de la cinta de opciones	Proporciona información general sobre el modelo de objetos fuertemente tipado que puede usar para obtener y establecer las propiedades de los controles de cinta de opciones en tiempo de ejecución.
Tutorial: Actualización de los controles de una cinta en tiempo de ejecución	Muestra cómo usar el modelo de objetos de la cinta para actualizar los controles de una cinta después de cargarla en la aplicación de Office.
Personalizar una cinta de opciones para Outlook	Proporciona instrucciones para personalizar la cinta de opciones en Microsoft Office Outlook.
Personalización de una cinta de opciones para InfoPath	Proporciona instrucciones para personalizar la cinta de opciones en Microsoft Office InfoPath.
Acceso a la cinta de opciones en tiempo de ejecución	Muestra cómo mostrar, ocultar y modificar la cinta de opciones y permitir que los usuarios ejecuten el código desde controles en un panel de tareas personalizado, un panel de acciones o un área de formulario de Outlook.
Cómo: Cambiar la posición de una pestaña en la cinta de opciones	Muestra cómo cambiar el orden de las pestañas de una cinta de opciones.
Cómo: Personalizar una pestaña integrada	Muestra cómo agregar grupos y controles a una pestaña integrada.
Cómo: Agregar controles a la vista Backstage	Muestra cómo agregar controles al menú que se abre al hacer clic en el archivo.
Cómo: Agregar un iniciador de cuadros de diálogo a un grupo de cintas	Muestra cómo agregar un iniciador de cuadros de diálogo a cualquier grupo de una cinta de opciones.
Cómo: Exportar una cinta de opciones del Diseñador de cintas a XML de la cinta	Muestra cómo personalizar la cinta de opciones de maneras avanzadas mediante la exportación de la cinta de opciones desde el diseñador a XML de la cinta de opciones.
Ribbon XML	Explica cómo puede personalizar una cinta mediante XML de la cinta de opciones.
Tutorial: Creación de una pestaña personalizada mediante el Diseñador de cintas	Muestra cómo crear una pestaña personalizada de cinta de opciones mediante el elemento Cinta de opciones (XML).