RibbonGroup.DialogLauncherClick, événement

Article
05/16/2013

Se produit lorsque l'utilisateur clique sur l'icône du lanceur de boîte de dialogue du ruban dans le groupe.

Espace de noms : Microsoft.Office.Tools.Ribbon
Assembly : Microsoft.Office.Tools.Common (dans Microsoft.Office.Tools.Common.dll)

Syntaxe

'Déclaration
Event DialogLauncherClick As RibbonControlEventHandler

event RibbonControlEventHandler DialogLauncherClick

Notes

Le lanceur de boîte de dialogue du ruban est une petite icône qui apparaît dans le groupe.Lorsque l'utilisateur clique sur cette icône, vous pouvez gérer l'événement DialogLauncherClick pour ouvrir une boîte de dialogue personnalisée.Par défaut, les groupes n'ont pas de lanceur de boîte de dialogue du ruban.Pour plus d'informations, consultez Comment : ajouter un lanceur de boîte de dialogue à un groupe de ruban.

Exemples

L'exemple suivant indique comment ajouter un lanceur de boîte de dialogue à un groupe de ruban et comment lancer une boîte de dialogue personnalisée qui permet aux utilisateurs de choisir des paramètres avancés lorsqu'ils cliquent sur l'icône RibbonDialogLauncher dans l'angle inférieur droit de RibbonGroup.

Pour exécuter cet exemple de code, vous devez exécuter tout d'abord les étapes suivantes :

Ajoutez un élément Ruban (Concepteur visuel) à un projet Office.
Ajoutez RibbonDialogLauncher au groupe par défaut comme décrit dans Comment : ajouter un lanceur de boîte de dialogue à un groupe de ruban.
Si vous utilisez Visual Basic, ajoutez un nouvel élément Boîte de dialogue Windows Form au projet.Si vous utilisez C#, ajoutez un nouvel élément Windows Form et transformez-le en boîte de dialogue en ajoutant des boutons OK et Annuler au formulaire et en créant des gestionnaires d'événements pour les événements Click des boutons.
Définissez la propriété (Name) de la boîte de dialogue advancedSettingsDialog.Vous pouvez personnaliser la boîte de dialogue en ajoutant des contrôles et en définissant davantage de propriétés.
Ajoutez le gestionnaire d'événements DialogLauncherClick à votre code.
Placez le contenu de la méthode suivante dans le gestionnaire d'événements 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();
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

RibbonGroup Interface

Microsoft.Office.Tools.Ribbon, espace de noms

Autres ressources

Comment : ajouter un lanceur de boîte de dialogue à un groupe de ruban

Partager via