Structure NMTVDISPINFOA (commctrl.h)

Article
18/11/2024

Contient et reçoit des informations d’affichage pour un élément d’arborescence. Cette structure est identique à la structure TV_DISPINFO, mais elle a été renommée pour suivre les conventions d’affectation de noms actuelles.

Syntaxe

C++

typedef struct tagTVDISPINFOA {
  NMHDR   hdr;
  TVITEMA item;
} NMTVDISPINFOA, *LPNMTVDISPINFOA;

Membres

hdr

Type : NMHDR

structure NMHDR qui contient des informations sur cette notification.

item

Type : TVITEM

structure de TVITEM qui identifie et contient des informations sur l’élément d’arborescence. Le masque membre de la structure TVITEM spécifie les informations en cours de définition ou de récupération. Il peut s’agir d’une ou plusieurs des valeurs suivantes :

Valeur	Signification
TVIF_CHILDREN	Le membre cChildren spécifie, ou doit recevoir, une valeur qui indique si l’élément a des éléments enfants.
TVIF_IMAGE	Le membre iImage spécifie, ou doit recevoir, l’index de l’icône non sélectionnée de l’élément dans la liste d’images.
TVIF_SELECTEDIMAGE	Le membre iSelectedImage spécifie, ou doit recevoir, l’index de l’icône sélectionnée de l’élément dans la liste d’images.
TVIF_TEXT	Le pszText membre spécifie le nouveau texte d’élément ou l’adresse d’une mémoire tampon qui doit recevoir le texte de l’élément. Si la structure reçoit du texte d’élément, vous copiez généralement le texte vers la mémoire tampon pointée par le membre pszText de la structure TVITEM . Toutefois, vous pouvez retourner une chaîne dans le membre pszText à la place. Si vous le faites, vous ne pouvez pas modifier ou supprimer la chaîne tant que le texte de l’élément correspondant n’est pas supprimé ou jusqu’à ce que deux codes de notification supplémentaires TVN_GETDISPINFO aient été envoyés.

Remarques

Note

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

Voir aussi

de référence

TVN_SETDISPINFO

WM_NOTIFY

Partager via