ListView_SetItem macro (commctrl.h)

Définit tout ou partie des attributs d’un élément d’affichage de liste. Vous pouvez également utiliser ListView_SetItem pour définir le texte d’un sous-élément. Vous pouvez utiliser cette macro ou envoyer le message LVM_SETITEM explicitement.

Syntaxe

void ListView_SetItem(
   hwnd,
   pitem
);

Paramètres

hwnd

Type : HWND

Handle pour le contrôle d’affichage de liste.

pitem

Type : const LPLVITEM

Pointeur vers une structure LVITEM qui contient les nouveaux attributs d’élément. Les membres iItem et iSubItem identifient l’élément ou le sous-élément, et le membre mask spécifie les attributs à définir. Si le membre mask spécifie la valeur LVIF_TEXT, le membre pszText est l’adresse d’une chaîne terminée par null et le membre cchTextMax est ignoré. Si le membre mask spécifie la valeur LVIF_STATE, le membre stateMask spécifie les états d’élément à modifier et le membre d’état contient les valeurs de ces états.

Valeur de retour

None

Remarques

Pour définir les attributs d’un élément list-view, définissez le membre iItem de la structure LVITEM sur l’index de l’élément et définissez le membre iSubItem sur zéro. Pour un élément, vous pouvez utiliser les membres state, pszText, iImage et lParam de la structure LVITEM pour modifier ces paramètres d’élément.

Pour définir le texte d’un sous-élément, définissez les membres iItem et iSubItem pour indiquer le sous-élément spécifique, puis utilisez le membre pszText pour spécifier le texte. Vous pouvez également utiliser la macro ListView_SetItemText pour définir le texte d’un sous-élément. Vous ne pouvez pas définir les membres state ou lParam pour les sous-éléments, car les sous-éléments n’ont pas ces attributs. Dans les versions 4.70 et ultérieures, vous pouvez définir le membre iImage pour les sous-éléments. L’image de sous-élément s’affiche si le contrôle d’affichage de liste a le style étendu LVS_EX_SUBITEMIMAGES . Les versions précédentes ignorent l’image du sous-élément.

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