Información general de la cinta de opcionesRibbon overview

La cinta de opciones es una manera de organizar comandos relacionados para que sean fáciles de encontrar.The ribbon is a way to organize related commands so that they are easier to find. Los comandos aparecen como controles en la cinta de opciones.Commands appear as controls on the ribbon. Los controles se organizan en grupos a lo largo de una franja horizontal en el borde superior de una ventana de aplicación.Controls are organized into groups along a horizontal strip at the top edge of an application window. Los grupos relacionados se organizan en pestañas.Related groups are organized on tabs.

Ahora se puede acceder la mayoría de las características que antes de que se accedía mediante menús y barras de herramientas en versiones anteriores de Microsoft Office system mediante el uso de la cinta de opciones.Most of the features that were accessed by using menus and toolbars in earlier versions of the Microsoft Office system can now be accessed by using the ribbon. Para obtener más información, consulte el artículo técnico Introducción para desarrolladores de la interfaz de usuario de 2007 Microsoft Office system.For more information, see the technical article Developer overview of the user interface for the 2007 Microsoft Office system.

Se aplica a: La información de este tema se aplica al documento-proyectos y agregar de VSTO de nivel-en proyectos para las aplicaciones siguientes: Excel; InfoPath 2013 e InfoPath 2010; Outlook; PowerPoint; Proyecto; Visio; Word.Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for the following applications: Excel; InfoPath 2013 and InfoPath 2010; Outlook; PowerPoint; Project; Visio; Word. Para obtener más información, consulte características disponibles por tipo de aplicación y el proyecto de Office.For more information, see Features available by Office application and project type.

Personalizar la cinta de opciones de Microsoft OfficeCustomize the Microsoft Office Ribbon

Para personalizar la cinta de opciones, agregue uno de los siguientes elementos de la cinta de opciones al proyecto de Office:To customize the ribbon, add one of the following Ribbon items to your Office project:

  • Cinta (diseñador Visual)Ribbon (Visual Designer)

  • Cinta (XML)Ribbon (XML)

    Por ejemplo, para personalizar la cinta de Excel, agregue un elemento de cinta a un proyecto de complemento de Excel de VSTO.For example, to customize the Excel Ribbon, add a Ribbon item to an Excel VSTO Add-in project.

Elemento cinta (diseñador Visual)Ribbon (Visual Designer) item

El cinta (diseñador Visual) elemento proporciona herramientas avanzadas que facilitan el diseño y desarrollo de una cinta personalizada.The Ribbon (Visual Designer) item provides advanced tools that make it easier for you to design and develop a custom ribbon. Use la cinta (diseñador Visual) elemento para personalizar la cinta de opciones de las maneras siguientes:Use the Ribbon (Visual Designer) item to customize the ribbon in the following ways:

  • Agregar pestañas personalizadas o integradas a una cinta de opciones.Add custom or built-in tabs to a ribbon.

  • Agregue grupos personalizados a una pestaña personalizada o integrada.Add custom groups to a custom or built-in tab.

    Note

    Una pestaña integrada o un grupo es uno que ya existe en la cinta de opciones de una aplicación de Microsoft Office.A built-in tab or group is one that already exists on the ribbon of a Microsoft Office application. Por ejemplo, el datos ficha es una pestaña integrada en Excel.For example, the Data tab is a built-in tab in Excel. El conexiones grupo es un grupo integrado en el datos ficha.The Connections group is a built-in group on the Data tab.

  • Agregue controles personalizados a un grupo personalizado.Add custom controls to a custom group.

  • Agregue controles personalizados a la vista Backstage.Add custom controls to the Backstage View.

    Para obtener más información acerca de cómo personalizar una cinta mediante el cinta (diseñador Visual) de elemento, vea Diseñador de cinta.For more information about how to customize a ribbon by using the Ribbon (Visual Designer) item, see Ribbon designer.

Elemento cinta (XML)Ribbon (XML) item

Use la cinta (XML) del elemento si desea personalizar la cinta de opciones de forma que no es compatible con la cinta (diseñador Visual) elemento.Use the Ribbon (XML) item if you want to customize the ribbon in a way that is not supported by the Ribbon (Visual Designer) item. Use la cinta (XML) elemento para personalizar la cinta de opciones de las maneras siguientes:Use the Ribbon (XML) item to customize the ribbon in the following ways:

  • Agregar integrada grupos a una pestaña personalizada o integrada.Add built-in groups to a custom tab or built-in tab.

  • Agregue controles integrados a un grupo personalizado.Add built-in controls to a custom group.

  • Agregue código personalizado para invalidar los controladores de eventos de los controles integrados.Add custom code to override the event handlers of built-in controls.

  • Personalice la barra de herramientas de acceso rápido.Customize the Quick Access Toolbar.

  • Comparta una personalización de cinta entre el complemento de VSTO usando un identificador calificado.Share a Ribbon customization between VSTO Add-in by using a qualified ID.

    Para obtener más información acerca de cómo personalizar la cinta de opciones mediante la cinta (XML) de elemento, vea Ribbon XML.For more information about how to customize the ribbon by using the Ribbon (XML) item, see Ribbon XML.

Exportar una cinta desde el Diseñador de cinta al XML de cintaExport a ribbon from the Ribbon Designer to Ribbon XML

Si crea una cinta mediante el Diseñador de cinta de opciones y, a continuación, decide que desea personalizar la cinta de maneras que el cinta (diseñador Visual) elemento no admite, puede exportar la cinta de opciones a XML.If you create a ribbon by using the Ribbon Designer, and then decide that you want to customize the ribbon in ways that the Ribbon (Visual Designer) item does not support, you can export the ribbon to XML.

Visual Studio crea automáticamente un cinta (XML) de elemento y rellena el archivo XML de cinta con elementos y atributos para cada control en la cinta de opciones.Visual Studio automatically creates a Ribbon (XML) item and populates the Ribbon XML file with elements and attributes for each control on the ribbon.

No todas las propiedades que se encuentran en el propiedades ventana del Diseñador de cinta se transfieren al archivo XML de cinta de opciones.Not all of the properties that are in the Properties window of the Ribbon Designer are transferred to the Ribbon XML file. Por ejemplo, Visual Studio no exporta el valor de la imagen o texto propiedad.For example, Visual Studio does not export the value of the Image or Text property. 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.That is because you must create a callback method in the Ribbon code file of the exported project to assign an image or set the text of a control. Visual Studio no genera automáticamente métodos de devolución de llamada como parte del proceso de exportación.Visual Studio does not automatically generate callback methods as part of the export process.

Además, los valores de propiedad predeterminados sin modificar no aparecen en el archivo XML de la cinta resultante.In addition, any unchanged default property values do not appear in the resulting Ribbon XML file.

Para obtener más información acerca de cómo exportar la cinta de opciones a XML, vea Cómo: Exportar una cinta de opciones desde el Diseñador de cinta a cinta XML.For more information about how to export the Ribbon to XML, see How to: Export a ribbon from the Ribbon Designer to Ribbon XML.

Actualice el códigoUpdate the code

Se agrega un nuevo archivo de código de la cinta de opciones a el Explorador de soluciones.A new Ribbon code file is added to Solution Explorer. Este archivo contiene la clase XML de la cinta.This file contains the Ribbon XML class. 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.You must create callback methods in the Ribbon Callbacks region of this class to handle user actions, such as clicking a button. 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).Move your code from the event handlers to these callback methods and modify the code to work with the Ribbon extensibility (RibbonX) programming model. Para obtener más información, consulta Ribbon XML.For more information, see 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.You must also add code to the ThisAddIn, ThisWorkbook, or ThisDocument class that overrides the CreateRibbonExtensibilityObject method and returns the Ribbon XML class to the Office application.

Para obtener más información, consulta Ribbon XML.For more information, see Ribbon XML.

Agregar varios elementos de la cinta de opciones a un proyectoAdd multiple Ribbon items to a project

Puede agregar más de un elemento de cinta a un mismo proyecto.You can add more than one Ribbon item to a single project. Esto resulta útil si desea realizar alguna de las dos tareas indicadas a continuación:This is useful if you want to perform either of the following two tasks:

  • Crear cintas de opciones para Outlook inspectores.Create ribbons for Outlook Inspectors. Para obtener más información, consulte personalizar una cinta de opciones para Outlook.For more information, see Customize a ribbon for Outlook.

    Note

    Un Inspector es una ventana que se abre cuando los usuarios realizan ciertas tareas, como crear un mensaje de correo electrónico.An Inspector is a window that opens when users perform certain tasks, such as creating an e-mail message.

  • Seleccione qué cinta se mostrará en tiempo de ejecución.Select which ribbon to display at runtime.

Seleccione qué cintas de opciones para mostrar en tiempo de ejecuciónSelect which ribbons to display at runtime

Dado que un proyecto puede contener más de una cinta, puede seleccionar qué cinta se mostrará en tiempo de ejecución.Because a project can contain more than one ribbon, you can select which ribbon to display at runtime.

Para seleccionar una cinta se mostrará en tiempo de ejecución, invalide el CreateRibbonExtensibilityObject método en el ThisAddin, ThisWorkbook, o ThisDocument clase del proyecto y devuelva la cinta que desea mostrar.To select a ribbon to display at runtime, override the CreateRibbonExtensibilityObject method in the ThisAddin, ThisWorkbook, or ThisDocument class of your project and return the ribbon that you want to display. En el ejemplo siguiente se comprueba el valor de un campo denominado myCondition y devuelve la cinta adecuada.The following example checks the value of a field named myCondition and returns the appropriate ribbon.

Note

La sintaxis utilizada en este ejemplo devuelve una cinta de opciones que se creó mediante la cinta (diseñador Visual) elemento.The syntax used in this example returns a ribbon that was created by using the Ribbon (Visual Designer) item. La sintaxis para devolver una cinta de opciones que se crea mediante un cinta (XML) elemento es ligeramente diferente.The syntax for returning a ribbon that is created by using a Ribbon (XML) item is slightly different. Para obtener más información sobre cómo devolver un cinta (XML) de elemento, vea Ribbon XML.For more information about returning a Ribbon (XML) item, see Ribbon XML.

Agregue el código siguiente:Add the following code:

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
    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() });
        }
    }
TítuloTitle DescripciónDescription
Cómo: Introducción a la personalización de la cinta de opcionesHow to: Get started customizing the ribbon Se muestra cómo personalizar la cinta de opciones de una aplicación de Microsoft Office, agregar un cinta (diseñador Visual) o cinta (XML) a un proyecto de Office.Shows you how to customize the ribbon of a Microsoft Office application, add a Ribbon (Visual Designer) or Ribbon (XML) item to an Office project.
Diseñador de cintaRibbon designer Describe cómo puede utilizar el Diseñador de cinta de opciones para agregar pestañas personalizadas, grupos y controles a la cinta de opciones de una aplicación de Microsoft Office.Describes how you can use the Ribbon Designer to add custom tabs, groups, and controls to the ribbon of a Microsoft Office application.
Tutorial: Crear una pestaña personalizada usando el Diseñador de cinta de opcionesWalkthrough: Create a custom tab by using the Ribbon Designer Muestra cómo crear una pestaña personalizada de la cinta mediante el diseñador de la cinta.Shows you how to create a custom Ribbon tab by using the Ribbon Designer. Puede usar el diseñador de la cinta para agregar y colocar controles en la pestaña personalizada.You can use the Ribbon Designer to add and position controls on the custom tab.
Información general sobre el modelo de objetos de cinta de opcionesRibbon object model overview Proporciona información general del modelo de objetos fuertemente tipados que puede usar para obtener y establecer las propiedades de controles de cinta de opciones en tiempo de ejecución.Provides an overview of the strongly typed object model that you can use to get and set the properties of Ribbon controls at runtime.
Tutorial: Actualizar los controles de una cinta en tiempo de ejecuciónWalkthrough: Update the controls on a ribbon at runtime 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.Demonstrates how to use the Ribbon object model to update the controls on a ribbon after the ribbon is loaded into the Office application.
Personalizar una cinta de opciones para OutlookCustomize a ribbon for Outlook Proporciona instrucciones para personalizar la cinta de opciones en Microsoft Office Outlook.Provides guidance for customizing the ribbon in Microsoft Office Outlook.
Personalizar una cinta para InfoPathCustomize a ribbon for InfoPath Proporciona instrucciones para personalizar la cinta de opciones en Microsoft Office InfoPath.Provides guidance for customizing the ribbon in Microsoft Office InfoPath.
Obtener acceso a la cinta de opciones en tiempo de ejecuciónAccess the ribbon at runtime Se muestra cómo mostrar, ocultar y modificar la cinta de opciones y permitir que los usuarios ejecutar el código desde los controles en un panel de tareas personalizado, un panel de acciones o un formulario de Outlook.Shows how to show, hide, and modify the ribbon, and enable users to run the code from controls in a custom task pane, actions pane, or Outlook form region.
Cómo: Cambiar la posición de una pestaña en la cinta de opcionesHow to: Change the position of a tab on the ribbon Se muestra cómo cambiar el orden de las fichas en una cinta.Shows how to change the order of tabs on a ribbon.
Cómo: Personalizar una pestaña integradaHow to: Customize a built-in tab Muestra cómo agregar grupos y controles a una pestaña integrada.Shows how to add groups and controls to a built-in tab.
Cómo: Agregar controles a la vista BackstageHow to: Add controls to the Backstage View Muestra cómo agregar controles al menú que se abre al hacer clic en el archivo.Shows how to add controls to the menu that opens when you click the File.
Cómo: Agregar un selector de cuadro de diálogo a un grupo de cinta de opcionesHow to: Add a dialog box launcher to a Ribbon group Muestra cómo para agregar un selector de cuadro de diálogo a cualquier grupo de una cinta.Shows to add a dialog box launcher to any group on a ribbon.
Cómo: Exportar una cinta desde el Diseñador de cinta al XML de cintaHow to: Export a ribbon from the Ribbon Designer to Ribbon XML Muestra cómo personalizar la cinta de maneras avanzadas exportando la cinta de opciones desde el diseñador al XML de cinta.Shows how to customize the ribbon in advanced ways by exporting the ribbon from the designer to Ribbon XML.
Ribbon XMLRibbon XML Explica cómo puede personalizar una cinta de opciones mediante XML de cinta de opciones.Explains how you can customize a ribbon by using Ribbon XML.
Tutorial: Crear una pestaña personalizada usando el Diseñador de cinta de opcionesWalkthrough: Create a custom tab by using the Ribbon Designer Muestra cómo crear una pestaña personalizada de la cinta de opciones mediante la cinta (XML) elemento.Demonstrates how to create a custom Ribbon tab by using the Ribbon (XML) item.