LVM_GETNEXTITEM message

Recherche un élément d’affichage de liste qui a les propriétés spécifiées et qui porte la relation spécifiée avec un élément spécifié. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro ListView_GetNextItem .

Paramètres

wParam

Index de l’élément avec lequel commencer la recherche ou -1 pour rechercher le premier élément qui correspond aux indicateurs spécifiés. L’élément spécifié lui-même est exclu de la recherche.

lParam

Spécifie la relation à l’élément spécifié dans wParam. Il peut s’agir d’une ou d’une combinaison des valeurs suivantes :

Valeur	Signification
Recherche par index.
LVNI_ALL	Recherche un élément suivant par index, la valeur par défaut.
LVNI_PREVIOUS	Windows Vista et versions ultérieures : Recherche un élément classé avant l’élément spécifié dans wParam. L’indicateur LVNI_PREVIOUS n’est pas directionnel (LVNI_ABOVE trouverez l’élément positionné au-dessus, tandis que LVNI_PREVIOUS trouverez l’élément commandé avant.) L’indicateur LVNI_PREVIOUS inverse fondamentalement la logique de la recherche effectuée par les messages LVM_GETNEXTITEM ou LVM_GETNEXTITEMINDEX .
Recherche par relation physique à l’index de l’élément où la recherche doit commencer.
LVNI_ABOVE	Recherche un élément qui se trouve au-dessus de l’élément spécifié.
LVNI_BELOW	Recherche un élément qui se trouve sous l’élément spécifié.
LVNI_TOLEFT	Recherche un élément à gauche de l’élément spécifié.
LVNI_TORIGHT	Recherche un élément à droite de l’élément spécifié.
LVNI_DIRECTIONMASK	Windows Vista et versions ultérieures : Masque d’indicateur directionnel avec la valeur suivante : LVNI_ABOVE | LVNI_BELOW | LVNI_TOLEFT | LVNI_TORIGHT.
L’état de l’élément à rechercher peut être spécifié avec une ou une combinaison des valeurs suivantes :
LVNI_CUT	L’élément a l’indicateur d’état LVIS_CUT défini.
LVNI_DROPHILITED	L’élément a l’indicateur d’état LVIS_DROPHILITED défini
LVNI_FOCUSED	L’élément a l’indicateur d’état LVIS_FOCUSED défini.
LVNI_SELECTED	L’élément a l’indicateur d’état LVIS_SELECTED défini.
LVNI_STATEMASK	Windows Vista et versions ultérieures : Masque d’indicateur d’état avec la valeur suivante : LVNI_FOCUSED | LVNI_SELECTED | LVNI_CUT | LVNI_DROPHILITED.
Recherche par apparence d’éléments ou par groupe
LVNI_VISIBLEORDER	Windows Vista et versions ultérieures : Recherchez l’ordre visible.
LVNI_VISIBLEONLY	Windows Vista et versions ultérieures : Recherchez les éléments visibles.
LVNI_SAMEGROUPONLY	Windows Vista et versions ultérieures : Recherchez dans le groupe actif.
Si tous les indicateurs d’état spécifiés ne sont pas définis pour un élément, la recherche continue avec l’élément suivant.

Valeur retournée

Retourne l’index de l’élément suivant en cas de réussite, ou -1 dans le cas contraire.

Notes

Notez que les indicateurs suivants, à utiliser uniquement avec Windows Vista, s’excluent mutuellement des autres indicateurs utilisés : LVNI_VISIBLEONLY, LVNI_SAMEGROUPONLY, LVNI_VISIBLEORDER, LVNI_DIRECTIONMASK et LVNI_STATEMASK.

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