Gestion des notifications pour les info-bulles
Lorsque vous spécifiez le style ToSTYLE_TOOLTIPS, la barre d’outils crée et gère un contrôle d’info-bulle. Une info-bulle est une petite fenêtre contextuelle qui contient une ligne de texte décrivant un bouton de barre d’outils. L’info-bulle est masquée, apparaissant uniquement lorsque l’utilisateur place le curseur sur un bouton de barre d’outils et le laisse pendant environ une demi-seconde. L’info-bulle s’affiche près du curseur.
Avant l’affichage de l’info-bulle, le message de notification TTN_NEEDTEXT est envoyé à la fenêtre propriétaire de la barre d’outils pour récupérer le texte descriptif du bouton. Si la fenêtre propriétaire de la barre d’outils est une CFrameWnd
fenêtre, les info-bulles s’affichent sans effort supplémentaire, car CFrameWnd
dispose d’un gestionnaire par défaut pour la notification TTN_NEEDTEXT . Si la fenêtre propriétaire de la barre d’outils n’est pas dérivée CFrameWnd
d’une boîte de dialogue ou d’une vue de formulaire, vous devez ajouter une entrée à la carte des messages de votre fenêtre propriétaire et fournir un gestionnaire de notification dans la carte des messages. L’entrée de la carte de messages de la fenêtre propriétaire est la suivante :
ON_NOTIFY_EX(TTN_NEEDTEXT, 0, &CMyDialog::OnTtnNeedText)
Notes
memberFxn
Fonction membre à appeler lorsque le texte est nécessaire pour ce bouton.
Notez que l’ID d’une info-bulle est toujours 0.
Outre la notification TTN_NEEDTEXT , un contrôle d’info-bulle peut envoyer les notifications suivantes à un contrôle de barre d’outils :
Notification | Signification |
---|---|
TTN_NEEDTEXTA | Le contrôle info-bulle nécessite du texte ASCII (Windows 95 uniquement) |
TTN_NEEDTEXTW | Le contrôle info-bulle requiert du texte UNICODE (Windows NT uniquement) |
ToN_HOTITEMCHANGE | Indique que l’élément chaud (mis en surbrillance) a changé. |
NM_RCLICK | Indique que l’utilisateur a cliqué avec le bouton droit sur un bouton. |
ToN_DRAGOUT | Indique que l’utilisateur a cliqué sur le bouton et a déplacé le pointeur vers le bouton. Elle permet à une application d’implémenter le glisser-déplacer à partir d’un bouton de barre d’outils. Lors de la réception de cette notification, l’application démarre l’opération de glisser-déplacer. |
ToN_DROPDOWN | Indique que l’utilisateur a cliqué sur un bouton qui utilise le style ToSTYLE_DROPDOWN. |
ToN_GETOBJECT | Indique que l’utilisateur a déplacé le pointeur sur un bouton qui utilise le style ToSTYLE_DROPPABLE. |
Pour obtenir un exemple de fonction de gestionnaire et plus d’informations sur l’activation des conseils sur les outils, consultez l’Astuces de l’outil.