macro Header_GetItem (commctrl.h)

Article
02/26/2024

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

Syntaxe

void Header_GetItem(
   hwndHD,
   i,
   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 membre du masque indique le type d’informations demandées. Lorsque le message est retourné, les autres membres reçoivent les informations demandées. Si le membre du masque spécifie zéro, le message retourne TRUE , mais ne copie aucune information dans la structure.

Valeur de retour

None

Remarques

Si l’indicateur HDI_TEXT est défini dans le membre masque de la structure HDITEM , le contrôle peut modifier le membre pszText de la structure pour qu’il pointe 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, index, phdi)      \

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

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

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]
Plateforme cible	Windows
En-tête	commctrl.h

Partager via