NMLVGETINFOTIPW, structure (commctrl.h)

Contient et reçoit les informations d’élément d’affichage de liste nécessaires pour afficher 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. Voir les remarques.

pszText

Type : LPTSTR

Adresse d’une mémoire tampon de chaîne qui reçoit toutes les 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 deviez jamais supposer que cette mémoire tampon aura 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 actuellement pas utilisé et sera toujours égal à zéro.

lParam

Type : LPARAM

Valeur définie par l’application associée à l’élément. Ce membre n’est actuellement pas utilisé 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.

Note

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