Partager via

macro ListView_InsertItem (commctrl.h)

  • Article

Insère un nouvel élément dans un contrôle list-view. Vous pouvez utiliser cette macro ou envoyer le message LVM_INSERTITEM explicitement.

Syntaxe

void ListView_InsertItem(
   hwnd,
   pitem
);

Paramètres

hwnd

Type : HWND

Handle du contrôle list-view.

pitem

Type : const LPLVITEM

Pointeur vers une structure LVITEM qui spécifie les attributs de l’élément list-view. Utilisez le membre iItem pour spécifier l’index de base zéro auquel le nouvel élément doit être inséré. Si cette valeur est supérieure au nombre d’éléments actuellement contenus par le contrôle listview, le nouvel élément est ajouté à la fin de la liste et affecté à l’index correct. Examinez la valeur de retour de la macro pour déterminer l’index réel affecté à l’élément.

Valeur de retour

None

Remarques

Vous ne pouvez pas utiliser ListView_InsertItem ou LVM_INSERTITEM pour insérer des sous-éléments. Le membre iSubItem de la structure LVITEM doit être égal à zéro. Consultez LVM_SETITEM pour plus d’informations sur la définition des sous-éléments.

Si un contrôle list-view a le LVS_EX_CHECKBOXES de style défini, toute valeur placée en bits 12 à 15 du membre d’état de la structure LVITEM est ignorée. Lorsqu’un élément est ajouté avec ce jeu de style, il est toujours défini sur l’état décoché.

Si un contrôle d’affichage de liste a le style de fenêtre LVS_SORTASCENDING ou LVS_SORTDESCENDING , un message LVM_INSERTITEM échoue si vous essayez d’insérer un élément qui a LPSTR_TEXTCALLBACK en tant que membre pszText de sa structure LVITEM .

La macro ListView_InsertItem insère le nouvel élément à la position appropriée dans l’ordre de tri si les conditions suivantes sont remplies :

  • Vous utilisez l’un des styles LVS_SORTXXX.
  • Vous n’utilisez pas le style LVS_OWNERDRAW.
  • Le membre pszText de la structure pointée vers pitem n’est pas défini sur LPSTR_TEXTCALLBACK.

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