RibbonGroup.DialogLauncher (Propiedad)

Artículo
08/10/2011

Obtiene o establece el selector de cuadro de diálogo de la cinta de opciones que está asociado al grupo.

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

Sintaxis

'Declaración
Property DialogLauncher As RibbonDialogLauncher
    Get
    Set

RibbonDialogLauncher DialogLauncher { get; set; }

Valor de propiedad

Tipo: Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher
Selector de cuadro de diálogo de la cinta de opciones que está asociado al grupo.

Comentarios

El selector de cuadro de diálogo de la cinta de opciones es un icono pequeño que aparece en el grupo. Cuando el usuario hace clic en este icono, se puede administrar el evento DialogLauncherClick para abrir un cuadro de diálogo personalizado. De forma predeterminada, los grupos no tienen selector de cuadro de diálogo de la cinta de opciones. Para obtener más información, vea Cómo: Agregar un selector de cuadro de diálogo a un grupo de la cinta de opciones.

Para personalizar el comportamiento del selector de cuadro de diálogo de la cinta de opciones, use las propiedades de la interfaz RibbonDialogLauncher. Por ejemplo, para establecer la información en pantalla que aparece cuando el usuario mueve el puntero sobre el icono del selector de cuadro de diálogo, use la propiedad ScreenTip.

Algunas propiedades de la interfaz RibbonDialogLauncher, como la propiedad Image, solo son aplicables si el usuario final la agrega a la barra de herramientas de acceso rápido.

Ejemplos

En el ejemplo siguiente se muestra cómo establecer las propiedades ScreenTip y KeyTip en el RibbonDialogLauncher que se agrega al grupo predeterminado.

Para poder ejecutar este ejemplo de código, primero debe seguir este procedimiento:

Agregue un elemento Cinta (diseñador visual) a un proyecto de Office.
Agregue un RibbonDialogLauncher al Group1 del grupo predeterminado tal y como se describe en Cómo: Agregar un selector de cuadro de diálogo a un grupo de la cinta de opciones.

Private Sub SetDialogLauncherProperties()
    Group1.DialogLauncher.KeyTip = "A"
    Group1.DialogLauncher.ScreenTip = "Advanced Settings"
End Sub

private void SetDialogLauncherProperties()
{
    group1.DialogLauncher.KeyTip = "A";
    group1.DialogLauncher.ScreenTip = "Advanced Settings";
}

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.