RibbonGallery (Interfaz)

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 (en Microsoft.Office.Tools.Common.dll)

Sintaxis

'Declaración
<GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")> _
Public Interface RibbonGallery _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

El tipo RibbonGallery expone los siguientes miembros.

Propiedades

	Nombre	Descripción
	Buttons	Obtiene la colección de botones de este objeto RibbonGallery.
	ColumnCount	Obtiene o establece el número de columnas de Item en este objeto RibbonGallery.
	ControlSize	Obtiene o establece el tamaño del control RibbonGallery.
	Description	Obtiene o establece el texto que aparece en este control RibbonGallery de un botón de división o menú.
	Enabled	Obtiene o establece un valor que indica si este objeto RibbonControl está habilitado. (Se hereda de RibbonControl).
	Id	Obtiene una cadena que Microsoft Office usa para identificar este objeto RibbonControl. (Se hereda de RibbonControl).
	Image	Obtiene o establece la imagen que se muestra en el botón.
	ImageName	Obtiene o establece el nombre que se puede utilizar para identificar el control RibbonGallery en el controlador de eventos LoadImage.
	ItemImageSize	Obtiene o establece un valor de Size que proporciona las dimensiones de las imágenes que se muestran en los elementos de este control RibbonGallery.
	Items	Obtiene una colección de los componentes RibbonDropDownItem de este control RibbonGallery.
	KeyTip	Obtiene o establece el método abreviado de teclado para este control RibbonGallery.
	Label	Obtiene o establece el texto que aparece en este control RibbonGallery.
	Name	Obtiene o establece el nombre de este objeto RibbonComponent. (Se hereda de RibbonComponent).
	OfficeImageId	Obtiene o establece la imagen que se va a mostrar en el control si desea utilizar un icono integrado de Microsoft Office.
	Parent	Obtiene un objeto RibbonComponent que representa el elemento primario de este objeto RibbonComponent. (Se hereda de RibbonComponent).
	Position	Obtiene o establece la posición de la galería si ésta se encuentra en el menú de Microsoft Office.
	Ribbon	Obtiene el objeto Ribbon de nivel superior que contiene la jerarquía de controles. (Se hereda de RibbonComponent).
	RibbonUI	Infraestructura. Obtiene la instancia de IRibbonUI que la aplicación de Microsoft Office proporciona al código de extensibilidad de la cinta. (Se hereda de RibbonComponent).
	RowCount	Obtiene o establece el número de filas de los componentes RibbonDropDownItem que este control RibbonGallery muestra.
	ScreenTip	Obtiene o establece el texto de la información en pantalla que aparece cuando el usuario mueve el puntero sobre este control RibbonGallery.
	SelectedItem	Obtiene o establece el elemento actualmente seleccionado.
	SelectedItemIndex	Obtiene o establece el índice del objeto RibbonDropDownItem actualmente seleccionado.
	ShowImage	Obtiene o establece un valor que indica si está visible la imagen asociada al control RibbonGallery.
	ShowItemImage	Obtiene o establece un valor que indica si se muestran las imágenes de los elementos de la galería.
	ShowItemLabel	Obtiene o establece un valor que indica si se muestran las etiquetas de los elementos de este control RibbonGallery.
	ShowItemSelection	Obtiene o establece un valor que indica si el objeto RibbonDropDownItem actualmente seleccionado se diferencia visualmente de los elementos no seleccionados.
	ShowLabel	Obtiene o establece un valor que indica si está visible la etiqueta de este control RibbonGallery.
	Site	Obtiene o establece el ISite asociado a IComponent. (Se hereda de IComponent).
	SuperTip	Obtiene o establece el texto de varias líneas de la información sobre herramientas que aparece cuando el usuario mueve el puntero sobre el control RibbonGallery.
	Tag	Obtiene o establece los datos específicos de la aplicación que están asociados a este objeto RibbonComponent. (Se hereda de RibbonComponent).
	Visible	Obtiene o establece un valor que indica si este objeto RibbonControl está visible. (Se hereda de RibbonControl).

Arriba

Métodos

	Nombre	Descripción
	Dispose	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Se hereda de IDisposable).
	PerformDynamicLayout	Llama al método Microsoft.Office.Core.IRibbonUI.InvalidateControl del control principal si RibbonComponent tiene un elemento primario dinámico, como un menú dinámico, y no se suspende el diseño. (Se hereda de RibbonComponent).
	PerformLayout	Llama a Microsoft.Office.Core.IRibbonUI.InvalidateControl si el objeto RibbonComponent tiene un elemento primario y no se ha suspendido el diseño. (Se hereda de RibbonComponent).
	ResumeLayout()	Invierte el efecto del método SuspendLayout. (Se hereda de RibbonComponent).
	ResumeLayout(Boolean)	Invierte el efecto del método SuspendLayout. (Se hereda de RibbonComponent).
	SuspendLayout	Evita que la aplicación de Microsoft Office actualice el estado de los controles de la cinta de opciones. (Se hereda de RibbonComponent).

Arriba

Eventos

	Nombre	Descripción
	ButtonClick	Se produce cuando el usuario hace clic en un botón de este control RibbonGallery.
	Click	Se produce cuando el usuario hace clic en un elemento de este control RibbonGallery.
	Disposed	Representa el método que controla el evento Disposed de un componente. (Se hereda de IComponent).
	ItemsLoading	Se produce cuando se abre este control RibbonGallery.

Arriba

Comentarios

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

A diferencia de la interfaz RibbonDropDown, la interfaz RibbonGallery genera 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.

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.

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.

Puede crear un RibbonGallery en tiempo de ejecución utilizando el método CreateRibbonGallery del objeto RibbonFactory.

Existen dos maneras de obtener acceso al objeto RibbonFactory:

Mediante la propiedad Factory de la clase Ribbon.Utilice este enfoque para código en la clase Ribbon.
Mediante el método Globals.Factory.GetRibbonFactory.Utilice este enfoque para código fuera de la clase Ribbon.

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.

[!NOTA]

Esta interfaz está implementada por el Runtime de Microsoft Visual Studio Tools para Office. No está prevista su implementación en el código. Para obtener más información, vea Información general sobre el Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office.

Uso

En esta documentación se describe la versión de este tipo que se usa en los proyectos de Office destinados a .NET Framework 4 y .NET Framework 4.5. En los proyectos destinados a .NET Framework 3.5, este tipo podría tener unos miembros diferentes y los ejemplos de código de este tipo podrían no funcionar. Para informarse sobre este tipo en los proyectos destinados a .NET Framework 3.5, vea la siguiente sección de referencia en la documentación de Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.