RibbonGroup.DialogLauncher, propriété

Article
05/16/2013

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 :

Ajoutez un élément Ruban (Concepteur visuel) à un projet Office.
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

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.