RibbonDropDown Interfaz

Referencia

Definición

Espacio de nombres:: Microsoft.Office.Tools.Ribbon

Ensamblado:: Microsoft.Office.Tools.Common.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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.

public interface class RibbonDropDown : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")>]
type RibbonDropDown = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonDropDown
Implements IComponent, IDisposable, RibbonControl

Atributos: GuidAttribute

Implementaciones: RibbonComponent RibbonControl IComponent IDisposable

Comentarios

Un RibbonDropDown puede contener RibbonDropDownItem objetos y RibbonButton controles.

Puede crear un RibbonDropDown objeto en tiempo de ejecución mediante el CreateRibbonDropDown 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.

No puede agregar botones a la Buttons colección en tiempo de ejecución después de cargar la cinta de opciones en Office.

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

Para agregar objetos RibbonDropDownItem en tiempo de diseño

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

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

Para agregar controles RibbonButton en tiempo de diseño

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

Algunos miembros de este tipo solo se pueden establecer antes de que la cinta de opciones se cargue 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 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 una colección de objetos RibbonButton que pertenece a este RibbonDropDown.
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 una imagen que se muestra en este objeto RibbonDropDown.
ImageName	Obtiene o establece el nombre que se puede utilizar en el controlador de eventos LoadImage para identificar una imagen del control.
Items	Obtiene una colección de los elementos de este objeto RibbonDropDown.
KeyTip	Obtiene o establece el método abreviado de teclado para este objeto RibbonDropDown.
Label	Obtiene o establece el texto que aparece en este objeto RibbonDropDown.
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 RibbonDropDown si desea utilizar un icono integrado de Microsoft Office.
Parent	Obtiene un objeto RibbonComponent que representa el elemento primario de este objeto RibbonComponent. (Heredado de RibbonComponent)
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)
ScreenTip	Obtiene o establece el texto de la información en pantalla que aparece cuando el usuario mueve el puntero sobre el objeto RibbonDropDown.
SelectedItem	Obtiene o establece el objeto RibbonDropDownItem que está 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 RibbonDropDown.
ShowItemImage	Obtiene o establece un valor que indica si las imágenes se muestran para los elementos del menú desplegable.
ShowItemLabel	Obtiene o establece un valor que indica si las etiquetas se muestran para los elementos del menú desplegable.
ShowLabel	Obtiene o establece un valor que indica si está visible la etiqueta de este objeto RibbonDropDown.
SizeString	Obtiene o establece una cadena que determina el tamaño del objeto RibbonDropDown.
SuperTip	Obtiene o establece el texto informativo de varias líneas que aparece cuando el usuario mueve el puntero sobre el objeto RibbonDropDown.
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 un objeto RibbonDropDown.
ItemsLoading	Se produce cuando los controles se cargan en RibbonDropDown.
SelectionChanged	Se produce cuando un usuario selecciona un nuevo elemento en un control desplegable de la cinta de opciones.

Se aplica a