Structure NMLVGETINFOTIPW (commctrl.h)

Contient et reçoit les informations d’élément d’affichage de liste nécessaires à l’affichage d’une info-bulle pour un élément. Cette structure est utilisée avec le code de notification LVN_GETINFOTIP .

Syntaxe

typedef struct tagNMLVGETINFOTIPW {
  NMHDR  hdr;
  DWORD  dwFlags;
  LPWSTR pszText;
  int    cchTextMax;
  int    iItem;
  int    iSubItem;
  LPARAM lParam;
} NMLVGETINFOTIPW, *LPNMLVGETINFOTIPW;

Membres

hdr

Type : NMHDR

Structure NMHDR qui contient des informations sur ce code de notification.

dwFlags

Type : DWORD

Zéro ou LVGIT_UNFOLDED. Consultez la section Notes.

pszText

Type : LPTSTR

Adresse d’une mémoire tampon de chaîne qui reçoit des informations de texte supplémentaires. Si dwFlags est égal à zéro, ce membre contient le texte de l’élément existant. Dans ce cas, vous devez ajouter tout texte supplémentaire à la fin de cette chaîne. La taille de cette mémoire tampon est spécifiée par la structure cchTextMax .

cchTextMax

Type : int

Taille, en caractères, de la mémoire tampon pointée par pszText. Bien que vous ne devriez jamais supposer que cette mémoire tampon sera d’une taille particulière, la valeur INFOTIPSIZE peut être utilisée à des fins de conception.

iItem

Type : int

Index de base zéro de l’élément auquel cette structure fait référence.

iSubItem

Type : int

Index de base unique du sous-élément auquel cette structure fait référence. Si ce membre est égal à zéro, la structure fait référence à l’élément et non à un sous-élément. Ce membre n’est pas utilisé actuellement et sera toujours égal à zéro.

lParam

Type : LPARAM

Valeur définie par l’application associée à l’élément. Ce membre n’est pas utilisé actuellement et sera toujours égal à zéro.

Remarques

Un élément est dit plié lorsque le texte actuellement affiché est tronqué. Si LVGIT_UNFOLDED est retourné dans dwFlags, le texte intégral de l’élément est déjà affiché. Il n’est donc pas nécessaire de l’afficher dans l’info-bulle.

Notes

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

Condition requise	Valeur
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