Compartir a través de


Acceso a la cinta de opciones en tiempo de ejecución

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.

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 ventanas de inspector concretas de Outlook.

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 proyectos de Visual Studio Tools para 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 en 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";
}

Vea también

Tareas

Tutorial: Crear una ficha 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

Información general sobre la cinta de opciones

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

Acceso a un área de formulario en tiempo de ejecución