macro Header_GetItem (commctrl.h)

Article
10/24/2024

Obtient des informations sur un élément dans un contrôle d’en-tête. Vous pouvez utiliser cette macro ou envoyer explicitement le message HDM_GETITEM.

Syntaxe

BOOL Header_GetItem(
   HWND     hwndHD,
   int      i,
   LPHDITEM phdi
);

Paramètres

hwndHD

Type : HWND

Handle du contrôle d’en-tête.

i

Type : int

Index de l’élément pour lequel les informations doivent être récupérées.

phdi

Type : LPHDITEM

Pointeur vers une structure HDITEM . Lorsque le message est envoyé, le masque masque membre indique le type d’informations demandées. Lorsque le message est retourné, les autres membres reçoivent les informations demandées. Si le masque membre spécifie zéro, le message retourne TRUE, mais ne copie aucune information dans la structure.

Valeur de retour

Type : BOOL

Retourne TRUE en cas de réussite ou FALSE sinon.

Remarques

Si l’indicateur HDI_TEXT est défini dans le masque membre de la structure HDITEM, le contrôle peut modifier le membre pszText de la structure pour pointer vers le nouveau texte au lieu de remplir la mémoire tampon avec le texte demandé. Les applications ne doivent pas supposer que le texte sera toujours placé dans la mémoire tampon demandée.

La macro Header_GetItem est définie comme suit :

#define Header_GetItem(hwndHD, i, phdi)      \

    (BOOL)SendMessage((hwndHD), HDM_GETITEM,   \

    (WPARAM)(int)(i), (LPARAM)(LPHDITEM)(phdi))

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]
plateforme cible	Windows
d’en-tête	commctrl.h

Partager via