RibbonGroup.DialogLauncher, propriété (System 2007)

Mise à jour : novembre 2007

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

Syntaxe

Public Property DialogLauncher As RibbonDialogLauncher

Dim instance As RibbonGroup
Dim value As RibbonDialogLauncher

value = instance.DialogLauncher

instance.DialogLauncher = value

public 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 la classe 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 la classe RibbonDialogLauncher, telles que la propriété Image, sont applicables uniquement lorsque l'utilisateur final l'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 Visual Studio Tools pour 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";
}

Autorisations

• 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, classe

Membres RibbonGroup

Microsoft.Office.Tools.Ribbon, espace de noms

Autres ressources

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