Fonction RegisterForTooltipDismissNotification (winuser.h)
Inscrit ou annule l’inscription des fenêtres pour recevoir une notification pour ignorer leurs fenêtres d’info-bulle.
Syntaxe
BOOL RegisterForTooltipDismissNotification(
HWND hWnd,
TOOLTIP_DISMISS_FLAGS tdFlags
);
Paramètres
hWnd
Type : HWND
Handle de la fenêtre pour recevoir le message WM_TOOLTIPDISMISS .
tdFlags
Type : TOOLTIP_DISMISS_FLAGS
Valeur de l’énumération qui spécifie si la fonction inscrit ou annule l’inscription de la fenêtre. TDF_REGISTER s’inscrire ; TDF_UNREGISTER désinscrire.
Valeur retournée
TRUE si la fenêtre a été inscrite ou non inscrite ; sinon, FALSE. (Consultez la section Notes.)
Notes
Cette fonction rend les info-bulles plus accessibles en permettant aux applications et aux frameworks qui prennent en charge les info-bulles d’inscription et de désinscription d’être averties par un message WM_TOOLTIPDISMISS lorsque le système exige que toutes les info-bulles affichant soient ignorées.
Les applications doivent s’inscrire à cette notification chaque fois qu’elles affichent une info-bulle et masquent leurs info-bulles en réponse à un message WM_TOOLTIPDISMISS . Lorsqu’une info-bulle est masquée pour une autre raison, comme une action de souris, l’application doit se désinscrire.
Les déclencheurs définis par le système pour le licenciement de l’info-bulle incluent une touche Ctrl solitaire vers le haut ou Ctrl+Maj+F10. (L’ensemble des déclencheurs peut changer au fil du temps.)
La fonction prend le HWND d’une fenêtre d’info-bulle ou le HWND d’une fenêtre d’application qui a des info-bulles enfants.
- Si une info-bulle HWND elle-même est inscrite, la fenêtre d’info-bulle est censée s’inscrire lors de l’affichage et de l’ignorer lors de la réception d’un message WM_TOOLTIPDISMISS .
- Si une application HWND s’inscrit pour le compte de ses info-bulles, la fenêtre de l’application est censée s’inscrire lors de l’affichage des info-bulles et ignorer toutes ses info-bulles lors de la réception d’un message WM_TOOLTIPDISMISS .
Les fenêtres d’info-bulle ou d’application doivent appeler la fonction pour s’inscrire chaque fois que des info-bulles sont affichées. Les fenêtres inscrites sont automatiquement désinsistées lors de la publication de WM_TOOLTIPDISMISS.
L’indicateur TDF_UNREGISTER est utilisé pour annuler explicitement l’inscription d’une fenêtre lorsqu’une fenêtre d’info-bulle est ignorée par une prérogative d’application ou d’infrastructure (par exemple, le déplacement du curseur hors de la « zone sécurisée »). Si une application ou une infrastructure appelle RegisterForTooltipDismissNotification avec TDF_UNREGISTER après la désinscription automatique de la fenêtre, la fonction retourne FALSE. Il n’y a aucun impact sur les inscriptions futures.
Valeurs de retour
Le HWND transmis à la fonction doit appartenir au processus appelant ; sinon, la fonction retourne FALSE.
Lorsqu’elle est appelée avec TDF_REGISTER et une fenêtre appartenant au processus appelant, la fonction retourne TRUE si la fenêtre a été inscrite avec succès ou FALSE si la fenêtre a déjà été inscrite. La fenêtre est traitée comme inscrite dans les deux sens.
Lorsqu’elle est appelée avec TDF_UNREGISTER et une fenêtre appartenant au processus appelant, la fonction retourne TRUE si la fenêtre est correctement désinscrit, ou FALSE si les fenêtres n’ont pas été actuellement inscrites. La fenêtre est traitée comme non inscrite dans les deux sens.
Spécifications
| Client minimal pris en charge | Windows 11 Build 22621 |
| Plateforme cible | Windows |
| En-tête | winuser.h |
| Bibliothèque | user32.lib |