Acceso a la cinta en tiempo de ejecución

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.

Puede acceder a la cinta de opciones mediante la clase Globals. 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.

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.

Acceso a la cinta de opciones mediante la clase Globals

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.

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

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.

C#

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

VB

Private Sub Access_All_Ribbons_Globals()
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World"
End Sub

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

Puede acceder a una colección de cintas que aparecen 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 acceder a la cinta de opciones de una ventana del Inspector, llame a la propiedad Ribbons de la clase Globals y pase un objeto Inspector que representa el Inspector.

En el ejemplo siguiente se obtiene la colección de la cinta de opciones del Inspector que actualmente tiene el foco. 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.

C#

private void Access_Ribbons_By_Inspector()
{
    ThisRibbonCollection ribbonCollection = 
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveInspector()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

VB

Private Sub Access_Ribbons_By_Inspector()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveInspector())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub

Obtener acceso a una colección de cintas que aparecen para un Explorador de Outlook específico

Puede acceder a una colección de cintas que aparecen en un Explorador de Outlook. Un explorador es la interfaz de usuario (UI) de la aplicación principal de una instancia de 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 Explorer que representa el Explorador.

En el ejemplo siguiente se obtiene la colección de la cinta de opciones del Explorador que actualmente tiene el foco. 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.

C#

private void Access_Ribbons_By_Explorer()
{
    ThisRibbonCollection ribbonCollection =
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

VB

Private Sub Access_Ribbons_By_Explorer()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveExplorer())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub

Contenido relacionado

• Introducción a la cinta de opciones
• Diseñador de la cinta
• Ribbon XML
• Introducción al modelo de objetos de la cinta de opciones
• Tutorial: Creación de una pestaña personalizada mediante el Diseñador de cintas
• Tutorial: Actualización de los controles de una cinta en tiempo de ejecución
• Personalizar una cinta de opciones para Outlook
• Acceso a un área del formulario en tiempo de ejecución