RibbonGallery (Clase) (2007 System)

Artículo
09/04/2008

Actualización: noviembre 2007

Representa un control que muestra un menú de objetos RibbonDropDownItem y controles RibbonButton.

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(RibbonGallery), "RibbonGallery.bmp")> _
Public NotInheritable Class RibbonGallery _
    Inherits RibbonControl

Dim instance As RibbonGallery

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

Comentarios

Al igual que la clase RibbonDropDown, RibbonGallery muestra un menú de objetos RibbonDropDownItem y controles RibbonButton.

A diferencia de la clase RibbonDropDown, la clase RibbonGallery provoca eventos Click, en lugar de eventos SelectionChanged, cuando el usuario hace clic en un objeto RibbonDropDownItem. Esto significa, por ejemplo, que el evento Click se provoca dos veces cuando el usuario hace dos veces clic en el mismo objeto RibbonDropDownItem. (El evento SelectionChanged se provocaría a lo sumo una vez cuando se realizó la selección inicial para el mismo escenario en una clase RibbonDropDown, según cuál fuese la selección antes del primer clic.)

La propiedad ShowItemSelection controla si el objeto RibbonDropDownItem actualmente seleccionado se diferencia visualmente de los elementos no seleccionados. Sólo se puede seleccionar un elemento a la vez en un objeto RibbonGallery.

Se puede usar la propiedad ItemImageSize para especificar tamaños de imagen distintos de 16x16 y 32x32.

Puede agregar objetos RibbonDropDownItem a un control RibbonGallery en tiempo de diseño o en tiempo de ejecución.

Para agregar objetos RibbonDropDownItem en tiempo de diseño

Haga clic en la propiedad Items en la ventana Propiedades.
Haga clic en los puntos suspensivos (...).
En el Editor de la colección DropDown, agregue, ordene y modifique los elementos nuevos.

En los siguientes pasos se explica cómo agregar un objeto RibbonDropDownItem en tiempo de ejecución.

Para agregar un objeto RibbonDropDownItem en tiempo de ejecución

Cree un nuevo objeto RibbonDropDownItem mediante el método RibbonDropDownItem.
Agregue el objeto RibbonDropDownItem creado a la colección Items de este objeto RibbonGallery.

Puede agregar controles RibbonButton a un objeto RibbonGallery en tiempo de diseño.

Para agregar controles RibbonButton en tiempo de diseño

Haga clic en la propiedad Buttons en la ventana Propiedades.
Haga clic en los puntos suspensivos (...).
En el Editor de la colección Button, agregue, ordene y modifique los nuevos controles de botón.

Algunas propiedades de este control sólo se pueden establecer antes de que se cargue la cinta de opciones en la aplicación de Office o antes de que se agregue el control a un menú dinámico en tiempo de ejecución. Para obtener información sobre cómo establecer estas propiedades, vea Información general sobre el modelo de objetos para la cinta de opciones.

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.RibbonGallery

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.