Partager via

Structure NMTTDISPINFOA (commctrl.h)

  • Article

Contient des 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 s’affiche en tant que texte d’info-bulle. Si spécifie un handle d’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 de la section remarques de ce document.

hinst

Type : HINSTANCE

Gérez l’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 être NULL.

uFlags

Type : UINT

Indicateurs qui indiquent comment interpréter le idFrom membre du NMHDR inclus structure.

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 mise 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 dans sa fenêtre parente. Pour qu’une info-bulle soit lue dans la direction opposée 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 la demande plus.

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 longueur deTCHAR. Le système supprime automatiquement l’ampersand (&) accélérateur TCHARs de toutes les chaînes passées à un contrôle d’info-bulle, sauf si le contrôle a le style TTS_NOPREFIX.

Note

L’en-tête commctrl.h définit NMTTDISPINFO comme 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.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
d’en-tête commctrl.h