Partager via


LVM_GETNEXTITEMINDEX message

Récupère l’index d’un élément dans un contrôle list-view spécifié qui correspond aux propriétés spécifiées et à la relation avec un autre élément. Envoyez ce message explicitement ou à l’aide de la macro ListView_GetNextItemIndex .

Paramètres

wParam [in, out]

Pointeur vers la structure LVITEMINDEX pour l’élément avec lequel commencer la recherche, ou -1 pour trouver le premier élément qui correspond aux indicateurs spécifiés. Le processus appelant est responsable de l’allocation de cette structure et de la définition de ses membres.

lParam

Spécifie la relation avec l’élément répertorié dans le paramètre 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.
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_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 placé au-dessus, tandis que LVNI_PREVIOUS trouverez l’élément commandé précédemment.) L’indicateur LVNI_PREVIOUS inverse fondamentalement la logique de la recherche effectuée par les messages LVM_GETNEXTITEM ou LVM_GETNEXTITEMINDEX.
LVNI_TORIGHT
Recherche un élément à droite de l’élément spécifié.
LVNI_DIRECTIONMASK
Windows Vista et versions ultérieures : Un 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’indicateur d’état LVIS_CUT est défini sur l’élément.
LVNI_DROPHILITED
L’indicateur d’état LVIS_DROPHILITED est défini sur l’élément
LVNI_FOCUSED
L’indicateur d’état LVIS_FOCUSED est défini sur l’élément.
LVNI_SELECTED
L’indicateur d’état LVIS_SELECTED est défini sur l’élément.
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 : Effectuez une recherche dans le groupe actif.
Si tous les indicateurs d’état spécifiés ne sont pas définis pour un élément, la recherche se poursuit avec l’élément suivant.

Valeur retournée

Retourne TRUE en cas de réussite, ou FALSE dans le cas contraire.

Notes

Notez que les indicateurs suivants, à utiliser uniquement avec Windows Vista, s’excluent mutuellement des autres indicateurs utilisés : LVNI_PREVIOUS, 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 2008 [applications de bureau uniquement]
En-tête
Commctrl.h

Voir aussi

LVM_GETNEXTITEM