Obtener acceso a la cinta de opciones en tiempo de ejecuciónAccess the Ribbon at runtime

Puede escribir código para mostrar, ocultar y modificar la cinta de opciones y permitir a los usuarios ejecutar el código desde los controles de un panel de tareas personalizado, un panel de acciones o un área del formulario de Outlook.You can write code 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.

Puede acceder a la cinta de opciones mediante la clase Globals.You can access the Ribbon by using the Globals class. Para los proyectos de Outlook, puede acceder a las cintas de opciones que aparecen en una ventana específica del Inspector de Outlook o del Explorador de Outlook.For Outlook projects, you can access the Ribbons that appear in a specific Outlook Inspector or Outlook Explorer window.

Aplicación: la información de este tema se aplica a los proyectos de nivel de documento y los proyectos de complemento de VSTO para las siguientes aplicaciones: Excel; InfoPath 2013 e InfoPath 2010; Outlook; PowerPoint; Project; 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 aplicación y tipo de proyecto de Office.For more information, see Features Available by Office Application and Project Type.

Obtener acceso a la cinta de opciones mediante la clase GlobalsAccess the Ribbon by using the Globals class

Puede usar la clase Globals para acceder a la cinta de opciones de un proyecto de nivel de documento o un proyecto de complemento de VSTO desde cualquier lugar del proyecto.You can use the Globals class to access the Ribbon in a document-level project or VSTO Add-in project from anywhere in the project.

Para obtener más información sobre la Globals de clases, consulte acceso Global a objetos en los proyectos de Office.For more information about the Globals class, see Global access to objects in Office projects.

En el ejemplo siguiente se usa la clase Globals para acceder a una cinta personalizada llamada Ribbon1 y establecer el texto que aparece en un cuadro combinado de la cinta de opciones para Hello World.The following example uses the Globals class to access a custom Ribbon named Ribbon1 and set the text that appears on a combo box on the Ribbon to Hello World.

Private Sub Access_All_Ribbons_Globals()
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World"
End Sub
private void Access_All_Ribbons_Globals()
{
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World";
}

Acceso a una colección de cintas de opciones que aparecen en una ventana específica del Inspector de OutlookAccess a collection of Ribbons that appear in a specific Outlook Inspector window

Puede tener acceso a una colección de cintas de opciones que aparecen en Outlook inspectores.You can access a collection of Ribbons that appear in Outlook Inspectors. Un Inspector es una ventana que se abre en Outlook cuando los usuarios realizan ciertas tareas, como crear mensajes de correo electrónico.An Inspector is a window that opens in Outlook when users perform certain tasks, such as creating e-mail messages. Para acceder a la cinta de opciones de una ventana del Inspector, llame a la propiedad Ribbons de la clase Globals y pase un objeto Microsoft.Office.Interop.Outlook.Inspector que representa el Inspector.To access the Ribbon of an Inspector window, call the Ribbons property of the Globals class and pass in an Microsoft.Office.Interop.Outlook.Inspector object that represents the Inspector.

En el ejemplo siguiente se obtiene la colección de la cinta de opciones del Inspector que actualmente tiene el foco.The following example gets the Ribbon collection of the Inspector that currently has focus. A continuación, se accede a una cinta de opciones llamada Ribbon1 y se establece el texto que aparece en un cuadro combinado de la cinta de opciones para Hello World.This example then accesses a Ribbon named Ribbon1 and sets the text that appears on a combo box on the Ribbon to Hello World.

Private Sub Access_Ribbons_By_Inspector()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveInspector())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub
private void Access_Ribbons_By_Inspector()
{
    ThisRibbonCollection ribbonCollection = 
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveInspector()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

Acceso a una colección de cintas de opciones que aparecen para un explorador de Outlook específicoAccess a collection of Ribbons that appear for a specific Outlook Explorer

Puede tener acceso a una colección de cintas de opciones que aparecen en un Outlook Explorer.You can access a collection of Ribbons that appear in an Outlook Explorer. Un explorador es la interfaz de usuario (UI) de la aplicación principal de una instancia de Outlook.An Explorer is the main application user interface (UI) for an instance of Outlook. Para acceder a la cinta de opciones de una ventana del Explorador, llame a la propiedad Ribbons de la clase Globals y pase un objeto Microsoft.Office.Interop.Outlook.Explorer que representa el Explorador.To access the Ribbon of an Explorer window, call the Ribbons property of the Globals class and pass in an Microsoft.Office.Interop.Outlook.Explorer object that represents the Explorer.

En el ejemplo siguiente se obtiene la colección de la cinta de opciones del Explorador que actualmente tiene el foco.The following example gets the Ribbon collection of the Explorer that currently has focus. A continuación, se accede a una cinta de opciones llamada Ribbon1 y se establece el texto que aparece en un cuadro combinado de la cinta de opciones para Hello World.This example then accesses a Ribbon named Ribbon1 and sets the text that appears on a combo box on the Ribbon to Hello World.

Private Sub Access_Ribbons_By_Explorer()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveExplorer())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub
private void Access_Ribbons_By_Explorer()
{
    ThisRibbonCollection ribbonCollection =
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

Vea tambiénSee also

Información general de la cinta de opciones Ribbon overview
Diseñador de la cinta Ribbon Designer
XML de la cinta de opciones Ribbon XML
Información general sobre el modelo de objetos de la cinta de opciones Ribbon object model overview
Tutorial: Crear una pestaña personalizada usando el Diseñador de la cinta de opciones Walkthrough: Create a custom tab by using the Ribbon Designer
Tutorial: Actualizar los controles de una cinta de opciones en tiempo de ejecución Walkthrough: Update the controls on a Ribbon at runtime
Personalizar una cinta de opciones para Outlook Customize a Ribbon for Outlook
Obtener acceso a un área de formulario en tiempo de ejecuciónAccess a form region at runtime