RibbonOfficeMenu (Clase) (2007 System)

Artículo
09/04/2008

Actualización: noviembre 2007

Proporciona acceso a los controles que se agregan al menú de Microsoft Office.

Espacio de nombres: Microsoft.Office.Tools.Ribbon
Ensamblado: Microsoft.Office.Tools.Common.v9.0 (en Microsoft.Office.Tools.Common.v9.0.dll)

Sintaxis

Public NotInheritable Class RibbonOfficeMenu _
    Inherits RibbonComponent

Dim instance As RibbonOfficeMenu

public sealed class RibbonOfficeMenu : RibbonComponent

Comentarios

Al agregar un elemento Cinta (diseñador visual) a un proyecto, Visual Studio Tools para Office asigna automáticamente un nuevo objeto RibbonOfficeMenu a la propiedad OfficeMenu de la clase OfficeRibbon generada. Use este objeto para agregar nuevos controles al menú de Microsoft Office en tiempo de ejecución o para tener acceso a los controles agregados al menú de Microsoft Office.

Puede agregar los controles en tiempo de ejecución, pero sólo antes de que se cargue la cinta de opciones. Cree una instancia del control y, a continuación, agregue el nuevo control a la colección Items. Para obtener más información, vea Información general sobre el modelo de objetos para la cinta de opciones.

Ejemplos

En el ejemplo siguiente se recorren en iteración los controles personalizados del menú de la cinta de opciones de Office y se muestran los nombres. Para poder ejecutar este ejemplo de código, primero debe seguir este procedimiento:

Agregue un elemento Cinta (diseñador visual) a un proyecto de Visual Studio Tools para Office.
Agregue un botón al Botón de Microsoft Office.
Establezca la propiedad (Name) del botón en myOfficeMenuButton.
Establezca la propiedad PositionType en AfterOfficeID bajo la propiedad Position.
Establezca la propiedad OfficeID en FilePrintMenu bajo la propiedad Position.

Private Sub ListOfficeRibbonCustomControls()
    System.Windows.Forms.MessageBox.Show( _
            "Listing all Office Menu custom controls...")
    For Each control As RibbonComponent In Globals.Ribbons.Ribbon1.OfficeMenu.Items
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name)
    Next
End Sub

private void ListOfficeRibbonCustomControls()
{
    System.Windows.Forms.MessageBox.Show(
        "Listing all Office Menu custom controls...");
    foreach (RibbonComponent control in Globals.Ribbons.Ribbon1.OfficeMenu.Items)
    {
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name);
    }
}

Jerarquía de herencia

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonComponent
        Microsoft.Office.Tools.Ribbon.RibbonOfficeMenu

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.