RibbonGroup.DialogLauncherClick (Evento)
Se produce cuando el usuario hace clic en el icono del selector de cuadro de diálogo de la cinta de opciones en el grupo.
Espacio de nombres: Microsoft.Office.Tools.Ribbon
Ensamblado: Microsoft.Office.Tools.Common (en Microsoft.Office.Tools.Common.dll)
Sintaxis
'Declaración
Event DialogLauncherClick As RibbonControlEventHandler
event RibbonControlEventHandler DialogLauncherClick
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.
Ejemplos
En el ejemplo siguiente se muestra cómo agregar un selector de cuadro de diálogo a un grupo de cinta de opciones y cómo iniciar un cuadro de diálogo personalizado que permita a los usuarios elegir la configuración avanzada cuando hacen clic en el icono RibbonDialogLauncher de la esquina inferior derecha de RibbonGroup.
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 RibbonDialogLauncher al 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.
Si está utilizando Visual Basic, agregue un nuevo elemento Cuadro de diálogo de formularios Windows Forms al proyecto. Si está utilizando C#, agregue un nuevo elemento de formularios Windows Forms y conviértalo en un cuadro de diálogo agregando un botón Aceptar y un botón Cancelar al formulario y creando los controladores de eventos para los eventos de clic de los botones.
Establezca la propiedad (Name) del cuadro de diálogo en advancedSettingsDialog. Puede personalizar el cuadro de diálogo agregando los controles y estableciendo más propiedades.
Agregue el controlador de eventos DialogLauncherClick al código.
Coloque el contenido del método siguiente en el controlador de eventos DialogLauncherClick.
Private Sub Group1_DialogLauncherClick(ByVal sender As Object, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles Group1.DialogLauncherClick
Dim dlg As advancedSettingsDialog = New advancedSettingsDialog()
dlg.ShowDialog()
End Sub
void group1_DialogLauncherClick(object sender, Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs e)
{
advancedSettingsDialog dlg = new advancedSettingsDialog();
dlg.ShowDialog();
}
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.
Vea también
Referencia
Microsoft.Office.Tools.Ribbon (Espacio de nombres)
Otros recursos
Cómo: Agregar un selector de cuadro de diálogo a un grupo de la cinta de opciones