Compartir a través de


RibbonSplitButton (Interfaz)

Representa un control de la cinta de opciones que combina un botón o botón de alternancia y un menú desplegable.

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

Sintaxis

'Declaración
<GuidAttribute("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")> _
Public Interface RibbonSplitButton _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable
[GuidAttribute("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")]
public interface RibbonSplitButton : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

El tipo RibbonSplitButton expone los siguientes miembros.

Propiedades

  Nombre Descripción
Propiedad pública ButtonEnabled Obtiene o establece un valor que indica si está habilitado el botón del control RibbonSplitButton.
Propiedad pública ButtonType Obtiene o establece el tipo del botón en el control RibbonSplitButton.
Propiedad pública Checked Obtiene o establece un valor que indica si el control RibbonSplitButton está presionado o no.
Propiedad pública ControlSize Obtiene o establece el tamaño del control RibbonSplitButton.
Propiedad pública Description Obtiene o establece el texto que aparece en este control RibbonSplitButton de un menú desplegable.
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 la imagen que se muestra en el control.
Propiedad pública ImageName Obtiene o establece el nombre que se puede utilizar en el controlador de eventos E:Microsoft.Office.Tools.Ribbon.LoadImage para identificar una imagen del control.
Propiedad pública Items Obtiene la colección de controles que hay en este control RibbonSplitButton.
Propiedad pública ItemSize Obtiene o establece el tamaño de los controles en el menú desplegable de RibbonSplitButton.
Propiedad pública KeyTip Obtiene o establece el método abreviado de teclado del control RibbonSplitButton.
Propiedad pública Label Obtiene o establece el texto del control RibbonSplitButton.
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 RibbonSplitButton si desea utilizar 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 Position Obtiene o establece la posición del control RibbonSplitButton si está en el menú de Microsoft Office.
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 la información sobre herramientas que aparece cuando el usuario mueve el puntero sobre el control RibbonSplitButton.
Propiedad pública ShowLabel Obtiene o establece un valor que indica si está visible la etiqueta del control RibbonSplitButton.
Propiedad pública Site Obtiene o establece el ISite asociado a IComponent. (Se hereda de IComponent).
Propiedad pública 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 RibbonSplitButton.
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 Title Obtiene o establece el título que aparece encima del control RibbonSplitButton si está en el menú de Microsoft Office.
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 Click Se produce cuando el usuario hace clic en el control RibbonSplitButton.
Evento público Disposed Representa el método que controla el evento Disposed de un componente. (Se hereda de IComponent).

Arriba

Comentarios

Un control RibbonSplitButton combina un botón o botón de alternancia y un menú desplegable.Para elegir entre el botón y el botón de alternancia, utilice la propiedad ButtonType.

A diferencia del control RibbonMenu, el control RibbonSplitButton no tiene la propiedad Dynamic, de modo que no se puede cambiar el contenido de la colección Items en tiempo de ejecución.

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

[!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.

Vea también

Referencia

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

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