Información general sobre la cinta de opciones

Artículo
04/28/2010

Actualización: noviembre 2007

Se aplica a
La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office. Tipo de proyecto Proyectos de nivel de documento Proyectos de nivel de aplicación Versión de Microsoft Office Excel 2007 Word 2007 Outlook 2007 PowerPoint 2007 Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office.

Tipo de proyecto

Proyectos de nivel de documento
Proyectos de nivel de aplicación

Versión de Microsoft Office

Excel 2007
Word 2007
Outlook 2007
PowerPoint 2007

Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

Microsoft Office System 2007 presenta un nuevo elemento de la interfaz de usuario denominado cinta de opciones. Puede usar Visual Studio Tools para Office para personalizar la cinta de opciones de las aplicaciones siguientes:

Microsoft Office Excel 2007
Microsoft Office Outlook 2007
Microsoft Office PowerPoint 2007
Microsoft Office Word 2007

Acerca de la cinta de opciones de Microsoft Office System

La cinta de opciones es una manera de organizar 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 la parte superior de una ventana de aplicación. Los grupos relacionados se organizan en fichas.

Ahora se puede tener acceso con la cinta de opciones a la mayoría de las características a las que se tenía acceso con menús y barras de herramientas en las versiones anteriores de Microsoft Office System. Para obtener más información, vea el artículo técnico Developer Overview of the User Interface for the 2007 Microsoft Office System.

Personalizar la cinta de opciones de Microsoft Office

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

Cinta (diseñador visual)
Cinta (XML)

Por ejemplo, para personalizar la cinta de opciones de Excel, agregue un elemento Cinta a un proyecto de complemento de Excel.

Elemento Cinta (diseñador visual)

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

Agregar fichas personalizadas o integradas a una cinta de opciones.

Agregar grupos personalizados a una ficha personalizada o integrada.

Nota:
Una ficha o un grupo integrados son los que ya existen en la cinta de opciones de una aplicación de Microsoft Office. Por ejemplo, la ficha Datos es una ficha integrada en Excel. El grupo Conexiones es un grupo integrado de la ficha Datos.

Agregar controles personalizados a un grupo personalizado.
Agregar controles personalizados al menú de Microsoft Office.

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

Elemento Cinta (XML)

Utilice el elemento Cinta (XML) si desea personalizar la cinta de opciones de una forma no compatible con el elemento Cinta (diseñador visual). Utilice el elemento Cinta (XML) para personalizar la cinta de opciones de las maneras siguientes:

Agregar grupos integrados a una ficha personalizada o integrada.
Agregar controles integrados a un grupo personalizado.
Agregar código personalizado para invalidar los controladores de eventos de controles integrados.
Personalizar la barra de herramientas de acceso rápido.
Compartir una personalización de la cinta de opciones entre complementos mediante un identificador certificado.

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

Exportar una cinta de opciones desde el diseñador de la cinta de opciones al archivo XML de la cinta de opciones

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

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

No todas las propiedades que están en la ventana Propiedades del diseñador de la cinta de opciones se transfieren al archivo XML de la cinta. Por ejemplo, Visual Studio Tools para Office no exporta el valor de las propiedades Image o Text. Eso se debe a que tiene que crear un método de devolución de llamada en el archivo de código de la cinta de opciones del proyecto exportado para asignar una imagen o establecer el texto de un control. Visual Studio Tools para Office no genera automáticamente los método 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 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 del diseñador de la cinta de opciones a XML de la cinta de opciones.

Actualizar el código

En el Explorador de soluciones se agrega un nuevo archivo de código de la cinta de opciones. Este archivo contiene la clase XML Ribbon. 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 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 de opciones (RibbonX). Para obtener más información, vea XML de la cinta de opciones.

También debe agregar código a las clases ThisAddIn, ThisWorkbooko ThisDocument que invalide el método CreateRibbonExtensibilityObject y devuelva la clase XML Ribbon a la aplicación de Office.

Para obtener más información, vea XML de la cinta de opciones.

Agregar varios elementos de cinta de opciones a un proyecto

Puede agregar más de un elemento de cinta de opciones a un único proyecto. Esto es útil si desea realizar una de las dos tareas siguientes:

Crear cintas de opciones para inspectores de Outlook.

Nota:

Un inspector es una ventana que se abre cuando los usuarios realizan ciertas tareas, como crear un mensaje de correo electrónico.
Seleccionar la cinta de opciones que se mostrará en tiempo de ejecución.

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

Crear cintas de opciones para inspectores de Outlook

Outlook no muestra la cinta de opciones en la ventana principal de la aplicación. En su lugar, Outlook la muestra cinta en un inspector. Puede agregar una cinta de opciones para cada inspector en un proyecto de complemento de Outlook. Para obtener más información, vea Personalizar una Cinta de opciones para Outlook.

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

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

Para seleccionar una cinta que se mostrará en tiempo de ejecución, invalide el método CreateRibbonExtensibilityObject en las clases ThisAddin, 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 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 New Microsoft.Office.Tools.Ribbon.RibbonManager _
            (New Microsoft.Office.Tools.Ribbon.OfficeRibbon() _
                 {New Ribbon1()})
    Else
        Return New Microsoft.Office.Tools.Ribbon.RibbonManager _
            (New Microsoft.Office.Tools.Ribbon.OfficeRibbon() _
                {New Ribbon2()})
    End If
End Function

    protected override Microsoft.Office.Core.IRibbonExtensibility
CreateRibbonExtensibilityObject()
    {
        if (myCondition == true)
        {
            return new Microsoft.Office.Tools.Ribbon.RibbonManager(
                new Microsoft.Office.Tools.Ribbon.OfficeRibbon[] 
                    { new Ribbon1() });
        }
        else
        {
            return new Microsoft.Office.Tools.Ribbon.RibbonManager(
                new Microsoft.Office.Tools.Ribbon.OfficeRibbon[] 
                    { new Ribbon2() });
        }
    }