Partager via


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