macro ListView_GetNextItemIndex (commctrl.h)

Article
10/24/2024

Obtient l’index de l’élément dans un contrôle d’affichage de liste particulier qui a les propriétés et la relation spécifiées à un autre élément spécifique. Utilisez cette macro ou envoyez explicitement le message LVM_GETNEXTITEMINDEX.

Syntaxe

BOOL ListView_GetNextItemIndex(
  [in]      HWND        hwnd,
  [in, out] LVITEMINDEX *plvii,
            LPARAM      flags
);

Paramètres

[in] hwnd

Type : HWND

Handle du contrôle list-view.

[in, out] plvii

Type : LVITEMINDEX*

Pointeur vers la structure LVITEMINDEX avec laquelle l’élément commence la recherche, ou -1 rechercher 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.

flags

Type : LPARAM

Relation avec l’élément spécifié dans le paramètre plvii. 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, 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 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 l’élément antérieur à l’élément spécifié. L’indicateur LVNI_PREVIOUS n’est pas directionnel (LVNI_ABOVE trouve l’élément positionné ci-dessus, tandis que LVNI_PREVIOUS trouve l’élément commandé avant.) L’indicateur LVNI_PREVIOUS inverse essentiellement la logique de la recherche effectuée via 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 : 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 : Rechercher dans l’ordre visible.
LVNI_VISIBLEONLY	Windows Vista et versions ultérieures : rechercher les éléments visibles.
LVNI_SAMEGROUPONLY	Windows Vista et versions ultérieures : Rechercher dans le groupe actif.
Si un élément n’a pas tous les indicateurs d’état spécifiés définis, la recherche continue avec l’élément suivant.

Valeur de retour

Type : BOOL

Retourne TRUE en cas de réussite ou FALSE sinon.

Remarques

Notez que les indicateurs suivants, pour une utilisation 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	commctrl.h

Voir aussi

LVM_GETNEXTITEM

Partager via