ListView_GetNextItemIndex, macro (commctrl.h)

Article
02/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 avec un autre élément spécifique. Utilisez cette macro ou envoyez explicitement le message LVM_GETNEXTITEMINDEX .

Syntaxe

void ListView_GetNextItemIndex(
  [in]       hwnd,
  [in, out]  plvii,
             flags
);

Paramètres

[in] hwnd

Type : HWND

Handle pour le contrôle d’affichage de liste.

[in, out] plvii

Type : LVITEMINDEX*

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

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, 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 l’élément qui précède l’élément spécifié. 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 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 : 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 de retour

None

Remarques

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.

Configuration requise

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]
Plateforme cible	Windows
En-tête	commctrl.h

Voir aussi

LVM_GETNEXTITEM

Share via