RibbonSplitButton Interfaz

Definición

Espacio de nombres:

Microsoft.Office.Tools.Ribbon

Ensamblado:

Microsoft.Office.Tools.Common.dll

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

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

[System.Runtime.InteropServices.Guid("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")]
public interface RibbonSplitButton : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")>]
type RibbonSplitButton = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonSplitButton
Implements IComponent, IDisposable, RibbonControl

Atributos

GuidAttribute

Implementaciones

RibbonComponent RibbonControl IComponent IDisposable

Comentarios

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

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

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

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

ButtonEnabled	Obtiene o establece un valor que indica si el botón en el objeto RibbonSplitButton está habilitado.
ButtonType	Obtiene o establece el tipo del botón en el objeto RibbonSplitButton.
Checked	Obtiene o establece un valor que indica si el control RibbonSplitButton está presionado o no.
ControlSize	Obtiene o establece el tamaño del control RibbonSplitButton .
Description	Obtiene o establece el texto que aparece en este control RibbonSplitButton de un menú desplegable.
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 control.
ImageName	Obtiene o establece el nombre que se puede usar en el controlador de eventos E:Microsoft.Office.Tools.Ribbon.LoadImage para identificar una imagen del control.
Items	Obtiene la colección de controles que se encuentran en este objeto RibbonSplitButton.
ItemSize	Obtiene o establece el tamaño de los controles del menú desplegable de RibbonSplitButton.
KeyTip	Obtiene o establece el método abreviado de teclado del control RibbonSplitButton.
Label	Obtiene o establece el texto en el control RibbonSplitButton.
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 RibbonSplitButton 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 del control RibbonSplitButton, si este está 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)
ScreenTip	Obtiene o establece el texto de la información sobre herramientas que aparece cuando el usuario mueve el puntero sobre el control RibbonSplitButton.
ShowLabel	Obtiene o establece un valor que indica si está visible la etiqueta del control RibbonSplitButton.
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.
Tag	Obtiene o establece los datos específicos de la aplicación que están asociados a este objeto RibbonComponent. (Heredado de RibbonComponent)
Title	Obtiene o establece el título que aparece en la parte superior del control RibbonSplitButton si este está en el menú de Microsoft Office.
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

Click

Se produce cuando el usuario hace clic en el control RibbonSplitButton.