Structure NMTTDISPINFOA (commctrl.h)

Article
08/22/2023

Contient les informations utilisées pour gérer le code de notification TTN_GETDISPINFO . Cette structure remplace la structure TOOLTIPTEXT .

Syntaxe

typedef struct tagNMTTDISPINFOA {
  NMHDR     hdr;
  LPSTR     lpszText;
  char      szText[80];
  HINSTANCE hinst;
  UINT      uFlags;
  LPARAM    lParam;
} NMTTDISPINFOA, *LPNMTTDISPINFOA;

Membres

hdr

Type : NMHDR

Structure NMHDR qui contient des informations supplémentaires sur la notification.

lpszText

Type : LPTSTR

Pointeur vers une chaîne terminée par null qui sera affichée en tant que texte d’info-bulle. Si hinst spécifie un handle instance, ce membre doit être l’identificateur d’une ressource de chaîne.

szText[80]

Type : TCHAR

Mémoire tampon qui reçoit le texte de l’info-bulle. Une application peut copier le texte dans cette mémoire tampon au lieu de spécifier une adresse de chaîne ou une ressource de chaîne. Pour le texte d’info-bulle qui dépasse 80 TCHAR, consultez les commentaires dans la section remarques de ce document.

hinst

Type : HINSTANCE

Gérez vers le instance qui contient une ressource de chaîne à utiliser comme texte d’info-bulle. Si lpszText est l’adresse de la chaîne de texte d’info-bulle, ce membre doit avoir la valeur NULL.

uFlags

Type : UINT

Indicateurs qui indiquent comment interpréter le membre idFrom de la structure NMHDR incluse.

Valeur	Signification
TTF_IDISHWND	Si cet indicateur est défini, idFrom est le handle de l’outil. Sinon, il s’agit de l’identificateur de l’outil.
TTF_RTLREADING	Windows peut être mis en miroir pour afficher des langues telles que l’hébreu ou l’arabe qui lisent de droite à gauche (RTL). Normalement, le texte d’info-bulle est lu dans la même direction que le texte de sa fenêtre parente. Pour qu’une info-bulle soit lue dans le sens inverse de sa fenêtre parente, ajoutez l’indicateur TTF_RTLREADING au membre uFlags lors du traitement de la notification.
TTF_DI_SETITEM	Version 4.70. Si vous ajoutez cet indicateur à uFlags lors du traitement de la notification, le contrôle d’info-bulle conserve les informations fournies et ne les demande pas à nouveau.

lParam

Type : LPARAM

Version 4.70. Données définies par l’application associées à l’outil.

Remarques

Vous devez pointer le tableau lpszText vers votre propre mémoire tampon privée lorsque le texte utilisé dans l’info-bulle dépasse 80 TCHAR. Le système supprime automatiquement les TCHAR de l’accélérateur (&) de toutes les chaînes passées à un contrôle d’info-bulle, sauf si le contrôle a le style TTS_NOPREFIX.

Notes

L’en-tête commctrl.h définit NMTTDISPINFO comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	commctrl.h