ListView_GetNextItemIndex, macro (commctrl.h)
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 un élément suivant par index, la valeur par défaut. |
|
|
|
Recherche un élément qui se trouve au-dessus de l’élément spécifié. |
|
Recherche un élément qui se trouve sous l’élément spécifié. |
|
Recherche un élément à gauche de l’élément spécifié. |
|
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. |
|
Recherche un élément à droite de l’élément spécifié. |
|
Windows Vista et versions ultérieures : Un masque d’indicateur directionnel avec la valeur suivante : LVNI_ABOVE | LVNI_BELOW | LVNI_TOLEFT | LVNI_TORIGHT. |
|
|
|
L’indicateur d’état LVIS_CUT est défini sur l’élément. |
|
L’indicateur d’état LVIS_DROPHILITED est défini sur l’élément |
|
L’indicateur d’état LVIS_FOCUSED est défini sur l’élément. |
|
L’indicateur d’état LVIS_SELECTED est défini sur l’élément. |
|
Windows Vista et versions ultérieures : Masque d’indicateur d’état avec la valeur suivante : LVNI_FOCUSED | LVNI_SELECTED | LVNI_CUT | LVNI_DROPHILITED. |
|
|
|
Windows Vista et versions ultérieures : Recherchez l’ordre visible. |
|
Windows Vista et versions ultérieures : Recherchez les éléments visibles. |
|
Windows Vista et versions ultérieures : Effectuez une recherche dans le groupe actif. |
|
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 |