LVM_SETITEMCOUNT message

Article
06/13/2023

Fait en sorte que le contrôle d’affichage de liste alloue de la mémoire pour le nombre spécifié d’éléments ou définit le nombre virtuel d’éléments dans un contrôle d’affichage de liste virtuel.

Paramètres

wParam

Nombre d’éléments que le contrôle d’affichage de liste contiendra finalement.

lParam

Version 4.70. Valeurs qui spécifient le comportement du contrôle list-view après la réinitialisation du nombre d’éléments. Cette valeur peut être une combinaison des éléments suivants :

Valeur	Signification
LVSICF_NOINVALIDATEALL	Le contrôle d’affichage de liste ne repeint pas, sauf si les éléments affectés sont actuellement affichés.
LVSICF_NOSCROLL	Le contrôle d’affichage de liste ne modifie pas la position de défilement lorsque le nombre d’éléments change.

Valeur retournée

Retourne une valeur différente de zéro en cas de réussite, ou zéro dans le cas contraire.

Notes

La façon dont la mémoire est allouée dépend de la façon dont le contrôle d’affichage de liste a été créé. Vous pouvez envoyer ce message explicitement ou utiliser les macros ListView_SetItemCount ou ListView_SetItemCountEx . Pour plus d’informations, consultez Virtual List-View Style.

Si le contrôle d’affichage de liste a été créé sans le style LVS_OWNERDATA , l’envoi de ce message entraîne l’allocation de ses structures de données internes pour le nombre d’éléments spécifié. Cela évite au contrôle d’allouer les structures de données chaque fois qu’un élément est ajouté.

Si le contrôle d’affichage de liste a été créé avec le style LVS_OWNERDATA (un affichage de liste virtuelle), l’envoi de ce message définit le nombre virtuel d’éléments que le contrôle contient.

Le paramètre lParam est destiné uniquement aux contrôles d’affichage de liste qui utilisent les styles LVS_OWNERDATA et LVS_REPORT ou LVS_LIST .

Lorsque l’affichage de liste de contrôle commun est un affichage de liste virtualisé (LVS_OWNERDATA), il existe une limite de 100 000 000 éléments sur l’affichage de liste. Dans ce scénario, LVM_SETITEMCOUNT retourne FALSE quand il a un wParam de 100 000 001.

Spécifications

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]
En-tête	Commctrl.h

Partager via