Partager via


RibbonGroup.DialogLauncher, propriété

Obtient ou définit le lanceur de boîte de dialogue du ruban associé au groupe.

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

Syntaxe

'Déclaration
Property DialogLauncher As RibbonDialogLauncher
RibbonDialogLauncher DialogLauncher { get; set; }

Valeur de propriété

Type : Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher
Lanceur de boîte de dialogue du ruban associé au groupe.

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.

Vous pouvez personnaliser le comportement du lanceur de boîte de dialogue du ruban à l'aide des propriétés de l'interface RibbonDialogLauncher.Par exemple, pour définir l'info-bulle qui apparaît lorsque l'utilisateur déplace le pointeur sur l'icône du lanceur de boîte de dialogue, utilisez la propriété ScreenTip.

Certaines propriétés de l'interface RibbonDialogLauncher, telles que la propriété Image, sont applicables uniquement lorsque l'utilisateur final les ajoute à la barre d'outils Accès rapide.

Exemples

L'exemple suivant indique comment définir les propriétés KeyTip et ScreenTip sur le RibbonDialogLauncher ajouté au groupe par défaut.

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

  1. Ajoutez un élément Ruban (Concepteur visuel) à un projet Office.

  2. Ajoutez un RibbonDialogLauncher au groupe par défaut Group1 comme décrit dans Comment : ajouter un lanceur de boîte de dialogue à un groupe de ruban.

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";
}

Sécurité .NET Framework

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