Compartir a través de


RibbonGallery Interfaz

Definición

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

public interface class RibbonGallery : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")>]
type RibbonGallery = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable
Public Interface RibbonGallery
Implements IComponent, IDisposable, RibbonControl
Atributos
Implementaciones

Comentarios

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

A diferencia de la RibbonDropDown interfaz , la RibbonGallery interfaz genera Click eventos, en lugar de SelectionChanged eventos, cuando un usuario hace clic en .RibbonDropDownItem Esto significa, por ejemplo, que el Click evento se genera dos veces cuando un usuario hace clic en el mismo RibbonDropDownItem doble. (El SelectionChanged evento se generaría como máximo una vez cuando se realizó la selección inicial para el mismo escenario en , RibbonDropDowndependiendo de cuál era la selección antes del primer clic).

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

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

Para agregar objetos RibbonDropDownItem en tiempo de diseño

  1. Haga clic en la propiedad Items en la ventana Propiedades .

  2. Haga clic en los puntos suspensivos (...).

  3. En la colección Desplegable Editor, agregue, ordene y edite nuevos elementos.

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

Para agregar controles RibbonButton en tiempo de diseño

  1. Haga clic en la propiedad Buttons en la ventana Propiedades .

  2. Haga clic en los puntos suspensivos (...).

  3. En la colección de botones Editor, agregue, ordene y edite nuevos controles de botón.

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

Hay dos maneras de acceder al objeto RibbonFactory:

  • Mediante el uso de la propiedad Factory de la clase Ribbon. Use este enfoque desde el código en la clase Ribbon.

  • Usando el método Globals.Factory.GetRibbonFactory. Use este enfoque desde el código externo a la clase Ribbon.

Algunas propiedades de este control solo se pueden establecer 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 información sobre cómo establecer estas propiedades, vea Información general sobre el modelo de objetos de 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, consulta Visual Studio Tools for Office Runtime Overview.

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 o una versión posterior. 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, consulte la siguiente sección de referencia en la documentación de Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Propiedades

Buttons

Obtiene la colección de botones en este objeto RibbonGallery.

ColumnCount

Obtiene o establece el número de columnas Item de 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 menú o botón de expansión.

Enabled

Obtiene o establece un valor que indica si este objeto RibbonControl está habilitado.

(Heredado de RibbonControl)
Id

Obtiene una cadena que Microsoft Office usa para identificar este objeto RibbonControl.

(Heredado de RibbonControl)
Image

Obtiene o establece la imagen que se muestra en el botón.

ImageName

Obtiene o establece el nombre que puede usar para identificar el objeto RibbonGallery en el controlador de eventos LoadImage.

ItemImageSize

Obtiene o establece un objeto Size que proporciona las dimensiones de las imágenes que se muestran mediante los elementos de este objeto RibbonGallery.

Items

Obtiene una colección de los componentes RibbonDropDownItem de este objeto RibbonGallery.

KeyTip

Obtiene o establece el método abreviado de teclado para este objeto RibbonGallery.

Label

Obtiene o establece el texto que aparece en este objeto RibbonGallery.

Name

Obtiene o establece el nombre de este objeto RibbonComponent.

(Heredado de RibbonComponent)
OfficeImageId

Obtiene o establece la imagen que se va a mostrar en el control si quiere usar un icono integrado de Microsoft Office.

Parent

Obtiene un objeto RibbonComponent que representa el elemento primario de este objeto RibbonComponent.

(Heredado 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.

(Heredado de RibbonComponent)
RibbonUI

Obtiene la instancia de IRibbonUI que la aplicación de Microsoft Office proporciona al código de extensibilidad de la cinta.

(Heredado 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 objeto RibbonGallery.

SelectedItem

Obtiene o establece el elemento seleccionado actualmente.

SelectedItemIndex

Obtiene o establece el índice del objeto RibbonDropDownItem que está seleccionado actualmente.

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 las imágenes se muestran para 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 objeto RibbonGallery.

SuperTip

Obtiene o establece el texto informativo de varias líneas que aparece cuando el usuario mueve el puntero sobre el objeto RibbonGallery.

Tag

Obtiene o establece los datos específicos de la aplicación que están asociados a este objeto RibbonComponent.

(Heredado de RibbonComponent)
Visible

Obtiene o establece un valor que indica si este objeto RibbonControl está visible.

(Heredado de RibbonControl)

Métodos

PerformDynamicLayout()

Llama al método Microsoft.Office.Core.IRibbonUI.InvalidateControl del control primario si el objeto RibbonComponent tiene un elemento primario dinámico, como un menú dinámico, y no se suspende el diseño.

(Heredado de RibbonComponent)
PerformLayout()

Llama al método Microsoft.Office.Core.IRibbonUI.InvalidateControl si RibbonComponent tiene un elemento primario y no se suspende el diseño.

(Heredado de RibbonComponent)
ResumeLayout()

Invierte el efecto del método SuspendLayout().

(Heredado de RibbonComponent)
ResumeLayout(Boolean)

Invierte el efecto del método SuspendLayout().

(Heredado de RibbonComponent)
SuspendLayout()

Evita que la aplicación de Microsoft Office actualice el estado de los controles de la cinta de opciones.

(Heredado de RibbonComponent)

Eventos

ButtonClick

Se produce cuando un usuario hace clic en un botón de este objeto RibbonGallery.

Click

Se produce cuando un usuario hace clic en un elemento de este objeto RibbonGallery.

ItemsLoading

Se produce cuando este objeto RibbonGallery se abre.

Se aplica a