RibbonGroup.DialogLauncher (Propiedad) (2007 System)

Artículo
09/04/2008

Actualización: noviembre 2007

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.v9.0 (en Microsoft.Office.Tools.Common.v9.0.dll)

Sintaxis

Public Property DialogLauncher As RibbonDialogLauncher

Dim instance As RibbonGroup
Dim value As RibbonDialogLauncher

value = instance.DialogLauncher

instance.DialogLauncher = value

public 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 clase 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 clase RibbonDialogLauncher, como la propiedad Image, sólo 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 Visual Studio Tools para 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";
}

Permisos

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.