Obtener acceso a la cinta de opciones en tiempo de ejecución

Puede escribir código para mostrar, ocultar y modificar la cinta de opciones y permitir que los usuarios ejecuten el código desde los controles de un panel de tareas, un panel de acciones o un área de formulario de Outlook personalizados.

Puede obtener acceso a la cinta de opciones mediante la clase Globals. En los proyectos de Outlook, puede obtener acceso a las cintas de opciones que aparecen en una ventana de inspector o de explorador concreta de Outlook.

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

Obtener acceso a la cinta de opciones mediante la clase Globals

Puede utilizar la clase Globals para tener acceso a la cinta de opciones en un proyecto de nivel de documento o de nivel de aplicación desde cualquier parte del proyecto.

Para obtener más información sobre la clase Globals, vea Acceso global a objetos en los proyectos de Office.

En el ejemplo siguiente se utiliza la clase Globals para tener acceso a una cinta de opciones personalizada denominada Ribbon1 y establecer el texto que aparece en un cuadro combinado de la cinta en 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";
}

Obtener acceso a una colección de cintas de opciones que aparecen en una ventana de inspector específica de Outlook

Puede obtener acceso a una colección de cintas de opciones que aparece en inspectores de Outlook. Un inspector es una ventana que se abre en Outlook cuando los usuarios realizan ciertas tareas, como crear mensajes de correo electrónico. Para obtener acceso a la cinta de opciones de una ventana de inspector, llame a la propiedad Ribbons de la clase Globals y pase un objeto Inspector que represente al inspector.

En el ejemplo siguiente se obtiene la colección de cintas de opciones del inspector que tiene el foco en ese momento. A continuación, el ejemplo obtiene acceso a una cinta de opciones denominada Ribbon1 y establece el texto que aparece en un cuadro combinado de la cinta en 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";
}

Obtener acceso a una colección de cintas de opciones que aparecen en un explorador específico de Outlook

Puede obtener acceso a una colección de cintas de opciones que aparecen en un explorador de Outlook. Un explorador es la principal interfaz de usuario para una instancia de Outlook. Para obtener acceso a la cinta de opciones de una ventana de explorador, llame a la propiedad Ribbons de la clase Globals y pase un objeto Explorer que represente al explorador.

En el ejemplo siguiente, se obtiene la colección de cintas de opciones del explorador que tiene el foco en ese momento. A continuación, el ejemplo obtiene acceso a una cinta de opciones denominada Ribbon1 y establece el texto que aparece en un cuadro combinado de la cinta en 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én

Tareas

Tutorial: Crear una pestaña personalizada usando el diseñador de la cinta de opciones

Tutorial: Actualizar los controles de una cinta de opciones en tiempo de ejecución

Conceptos

Diseñador de la cinta de opciones

XML de la cinta de opciones

Información general sobre el modelo de objetos para la cinta de opciones

Personalizar una cinta de opciones para Outlook

Obtener acceso a un área de formulario en tiempo de ejecución

Otros recursos

Información general sobre la cinta de opciones