RibbonMenu (Clase) (2007 System)

Artículo
09/04/2008

Actualización: noviembre 2007

Representa un menú en una ficha de la cinta de opciones o en el 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

<ToolboxBitmapAttribute(GetType(RibbonMenu), "RibbonMenu.bmp")> _
Public NotInheritable Class RibbonMenu _
    Inherits RibbonControl

Dim instance As RibbonMenu

[ToolboxBitmapAttribute(typeof(RibbonMenu), "RibbonMenu.bmp")]
public sealed class RibbonMenu : RibbonControl

Comentarios

Visual Studio Tools para Office crea una instancia de la clase RibbonMenu cuando se arrastra un control Menu de la ficha Controles de la cinta de opciones de Office del Cuadro de herramientas al diseñador de la cinta de opciones.

Tareas comunes

En la tabla siguiente se muestran los miembros que son útiles para las tareas comunes. Todas estas tareas se pueden realizar en tiempo de diseño. Algunas de estas tareas se pueden realizar en tiempo de ejecución sólo antes de que la cinta de opciones se cargue en la aplicación de Office o antes de que el control se agregue a un menú dinámico en tiempo de ejecución. Para obtener más información, vea Información general sobre el modelo de objetos para la cinta de opciones.

Tarea	Miembro
Muestre una imagen en el menú.	Use la propiedad Image o ImageName. También puede reutilizar las imágenes que aparecen en los controles Ribbon integrados. Para ello, establezca OfficeImageId en el Id. de una imagen de Microsoft Office integrada que desee mostrar como icono para el menú.
Cambie el tamaño del menú.	Establezca la propiedad ControlSize en el valor que desee. Por ejemplo, para un menú grande, establézcala en Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.
Cambie el tamaño de los elementos en el menú.	Establezca la propiedad ItemSize en el valor que desee. Por ejemplo, para mostrar elementos grandes, establézcala en Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.
Habilite los cambios al menú en tiempo de ejecución (por ejemplo, para permitir agregar los controles al menú en tiempo de ejecución).	Establezca la propiedad Dynamic en true.
Tenga acceso a los controles en el menú, agregue los controles al menú o quite los controles del menú.	Utilice la propiedad Items.
Agregue un menú al menú, a un grupo o a otro control de Microsoft Office que puedan contener menús.	Cree una instancia de la clase RibbonMenu mediante el constructor RibbonMenu y, a continuación, agregue el nuevo objeto RibbonMenu a la propiedad Items del menú, grupo o control de Microsoft Office.

Ejemplos

En el ejemplo siguiente se muestran cómo agregar y rellenar en tiempo de ejecución un submenú a un menú existente.

Para obtener un ejemplo más completo en el que se actualizan los controles en tiempo de ejecución y se obtienen datos de la base de datos de ejemplo AdventureWorks utilizando Language-Integrated Queries (LINQ), vea Tutorial: Actualizar los controles de una cinta de opciones en tiempo de ejecución.

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 grupo a la ficha personalizada.
Agregue un menú al grupo.
Establezca la propiedad (Name) del menú en CustomerMenu.
Establezca la propiedad Label del menú en Customers.
Establezca la propiedad Dynamic del menú en true.

De este modo, se pueden agregar y quitar controles del menú en tiempo de ejecución después de que se haya cargado la cinta de opciones en la aplicación de Office.

Private Sub PopulateCustomerMenu()
    ' Add two sub-menus to EmployeeMenu and populate each sub-menu
    ' First sub-menu
    Dim subMenu1 As New RibbonMenu()
    subMenu1.Dynamic = True
    subMenu1.Label = "A - M"
    subMenu1.Items.Add(New RibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Hall, Don"
    subMenu1.Items.Add(New RibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Valdez, Rachel"
    CustomerMenu.Items.Add(subMenu1)

    ' Second sub-menu
    Dim subMenu2 As New RibbonMenu()
    subMenu2.Dynamic = True
    subMenu2.Label = "N - Z"
    subMenu2.Items.Add(New RibbonToggleButton())
    CType(subMenu2.Items.Last(), RibbonToggleButton).Label = "Robinson, Alex"
    CustomerMenu.Items.Add(subMenu2)

End Sub

private void PopulateCustomerMenu()
{
    // Add two sub-menus to EmployeeMenu and populate each sub-menu
    // First sub-menu
    RibbonMenu subMenu1 = new RibbonMenu();
    subMenu1.Dynamic = true;
    subMenu1.Label = "A - M";
    subMenu1.Items.Add(new RibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Hall, Don";
    subMenu1.Items.Add(new RibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Valdez, Rachel";
    CustomerMenu.Items.Add(subMenu1);

    // Second sub-menu
    RibbonMenu subMenu2 = new RibbonMenu();
    subMenu2.Dynamic = true;
    subMenu2.Label = "N - Z";
    subMenu2.Items.Add(new RibbonToggleButton());
    ((RibbonToggleButton)subMenu2.Items.Last()).Label = "Robinson, Alex";
    CustomerMenu.Items.Add(subMenu2);
}

Jerarquía de herencia

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonComponent
        Microsoft.Office.Tools.Ribbon.RibbonControl
          Microsoft.Office.Tools.Ribbon.RibbonMenu

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.