Compartir a través de


RibbonDropDown (Interfaz)

Representa una lista de elementos entre los que un usuario puede elegir y una lista de botones de cinta de opciones en los que un usuario puede hacer clic.

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

Sintaxis

'Declaración
<GuidAttribute("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")> _
Public Interface RibbonDropDown _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable
[GuidAttribute("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

El tipo RibbonDropDown expone los siguientes miembros.

Propiedades

  Nombre Descripción
Propiedad pública Buttons Obtiene una colección de objetos RibbonButton que pertenecen a este objeto RibbonDropDown.
Propiedad pública Enabled Obtiene o establece un valor que indica si este objeto RibbonControl está habilitado. (Se hereda de RibbonControl).
Propiedad pública Id Obtiene una cadena que Microsoft Office usa para identificar este objeto RibbonControl. (Se hereda de RibbonControl).
Propiedad pública Image Obtiene o establece una imagen que se muestra en este objeto RibbonDropDown.
Propiedad pública ImageName Obtiene o establece el nombre que se puede usar en el controlador de eventos LoadImage para identificar una imagen del control.
Propiedad pública Items Obtiene una colección de los elementos de este objeto RibbonDropDown.
Propiedad pública KeyTip Obtiene o establece el método abreviado de teclado para este objeto RibbonDropDown.
Propiedad pública Label Obtiene o establece el texto que aparece en este objeto RibbonDropDown.
Propiedad pública Name Obtiene o establece el nombre de este objeto RibbonComponent. (Se hereda de RibbonComponent).
Propiedad pública OfficeImageId Obtiene o establece la imagen que se va a mostrar en el control RibbonDropDown si desea usar un icono integrado de Microsoft Office.
Propiedad pública Parent Obtiene un objeto RibbonComponent que representa el elemento primario de este objeto RibbonComponent. (Se hereda de RibbonComponent).
Propiedad pública Ribbon Obtiene el objeto Ribbon de nivel superior que contiene la jerarquía de controles. (Se hereda de RibbonComponent).
Propiedad pública 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).
Propiedad pública ScreenTip Obtiene o establece el texto de sugerencia que aparece cuando el usuario mueve el puntero sobre el objeto RibbonDropDown.
Propiedad pública SelectedItem Obtiene o establece el objeto RibbonDropDownItem que está seleccionado actualmente.
Propiedad pública SelectedItemIndex Obtiene o establece el índice del objeto RibbonDropDownItem actualmente seleccionado.
Propiedad pública ShowImage Obtiene o establece un valor que indica si está visible la imagen asociada al objeto RibbonDropDown.
Propiedad pública ShowItemImage Obtiene o establece un valor que indica si se muestran las imágenes de los elementos del menú desplegable.
Propiedad pública ShowItemLabel Obtiene o establece un valor que indica si se muestran las etiquetas de los elementos en el menú desplegable.
Propiedad pública ShowLabel Obtiene o establece un valor que indica si está visible la etiqueta de este control RibbonDropDown.
Propiedad pública Site Obtiene o establece la interfaz ISite asociada a la interfaz IComponent. (Se hereda de IComponent).
Propiedad pública SizeString Obtiene o establece una cadena que determina el tamaño de RibbonDropDown.
Propiedad pública SuperTip Obtiene o establece el texto informativo de varias líneas que aparece cuando el usuario mueve el puntero sobre el objeto RibbonDropDown.
Propiedad pública Tag Obtiene o establece los datos específicos de la aplicación que están asociados a este objeto RibbonComponent. (Se hereda de RibbonComponent).
Propiedad pública Visible Obtiene o establece un valor que indica si este objeto RibbonControl está visible. (Se hereda de RibbonControl).

Arriba

Métodos

  Nombre Descripción
Método público Dispose Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Se hereda de IDisposable).
Método público 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).
Método público 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).
Método público ResumeLayout() Invierte el efecto del método SuspendLayout. (Se hereda de RibbonComponent).
Método público ResumeLayout(Boolean) Invierte el efecto del método SuspendLayout. (Se hereda de RibbonComponent).
Método público 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
Evento público ButtonClick Se produce cuando un usuario hace clic en un botón en RibbonDropDown.
Evento público Disposed Representa el método que controla el evento Disposed de un componente. (Se hereda de IComponent).
Evento público ItemsLoading Se produce cuando los controles se cargan en RibbonDropDown.
Evento público SelectionChanged Se produce cuando un usuario selecciona un nuevo elemento en un control desplegable de la cinta de opciones.

Arriba

Comentarios

RibbonDropDown puede contener objetos RibbonDropDownItem y controles RibbonButton.

Puede crear un RibbonDropDown en tiempo de ejecución utilizando el método CreateRibbonDropDown 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.

No puede agregar botones a la colección Buttons en tiempo de ejecución una vez cargada la Cinta en Office.

En los procedimientos siguientes se explica cómo agregar objetos RibbonDropDownItem y controles RibbonButton a RibbonDropDown.

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 el Editor de la colección DropDown, agregue, ordene y modifique los elementos nuevos.

Puede agregar controles RibbonButton a un objeto RibbonDropDown en 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 el Editor de la colección Button, agregue, ordene y modifique los nuevos controles de botón.

Algunos miembros de este tipo sólo se pueden establecer antes de que se cargue la cinta de opciones en la aplicación de Office. 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 motor en tiempo de ejecución de 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

Esta documentación describe la versión de este tipo que se utiliza en los proyectos de Office destinados a .NET Framework 4. En los proyectos destinados a .NET Framework 3.5, este tipo puede tener miembros diferentes y es posible que los ejemplos de código proporcionados para dicho tipo no funcionen. 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.

Vea también

Referencia

Microsoft.Office.Tools.Ribbon (Espacio de nombres)

RibbonDropDown.Items

RibbonDropDown.Buttons

Otros recursos

Información general sobre la cinta de opciones

Diseñador de la cinta de opciones

Información general sobre el modelo de objetos para la cinta de opciones

Cómo: Iniciarse en la personalización de la cinta de opciones