Macro ListView_GetNextItemIndex (commctrl.h)

Articolo
02/24/2024

Ottiene l'indice dell'elemento in un particolare controllo di visualizzazione elenco con le proprietà specificate e la relazione con un altro elemento specifico. Usare questa macro o inviare il messaggio di LVM_GETNEXTITEMINDEX in modo esplicito.

Sintassi

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

Parametri

[in] hwnd

Tipo: HWND

Handle per il controllo di visualizzazione elenco.

[in, out] plvii

Tipo: LVITEMINDEX*

Puntatore alla struttura LVITEMINDEX con cui l'elemento inizia la ricerca o -1 per trovare il primo elemento corrispondente ai flag specificati. Il processo chiamante è responsabile dell'allocazione di questa struttura e dell'impostazione dei membri.

flags

Tipo: LPARAM

Relazione con l'elemento specificato nel parametro plvii. Questo può essere uno o una combinazione dei valori seguenti:

Valore	Significato
Cerca in base all'indice.
LVNI_ALL	Cerca un elemento successivo per indice, il valore predefinito.
Cerca per relazione fisica l'indice dell'elemento in cui inizia la ricerca.
LVNI_ABOVE	Cerca un elemento precedente all'elemento specificato.
LVNI_BELOW	Cerca un elemento che è sotto l'elemento specificato.
LVNI_TOLEFT	Cerca un elemento a sinistra dell'elemento specificato.
LVNI_PREVIOUS	Windows Vista e versioni successive: Cerca l'elemento precedente all'elemento specificato. Il flag LVNI_PREVIOUS non è direzionale (LVNI_ABOVE troverà l'elemento posizionato sopra, mentre LVNI_PREVIOUS troverà l'elemento ordinato prima. Il flag LVNI_PREVIOUS inverte essenzialmente la logica della ricerca eseguita tramite i messaggi LVM_GETNEXTITEM o LVM_GETNEXTITEMINDEX.
LVNI_TORIGHT	Cerca un elemento a destra dell'elemento specificato.
LVNI_DIRECTIONMASK	Windows Vista e versioni successive: Maschera di flag direzionale con valore: LVNI_ABOVE \| LVNI_BELOW \| LVNI_TOLEFT \| LVNI_TORIGHT.
Lo stato dell'elemento da trovare può essere specificato con una o una combinazione dei valori seguenti:
LVNI_CUT	L'elemento ha il flag di stato LVIS_CUT impostato.
LVNI_DROPHILITED	L'elemento ha il set di flag di stato LVIS_DROPHILITED
LVNI_FOCUSED	L'elemento ha il flag di stato LVIS_FOCUSED impostato.
LVNI_SELECTED	L'elemento ha il flag di stato LVIS_SELECTED impostato.
LVNI_STATEMASK	Windows Vista e versioni successive: Maschera del flag di stato con valore seguente: LVNI_FOCUSED \| LVNI_SELECTED \| LVNI_CUT \| LVNI_DROPHILITED.
Cerca in base all'aspetto di elementi o per gruppo.
LVNI_VISIBLEORDER	Windows Vista e versioni successive: Cercare l'ordine visibile.
LVNI_VISIBLEONLY	Windows Vista e versioni successive: Cercare gli elementi visibili.
LVNI_SAMEGROUPONLY	Windows Vista e versioni successive: Cercare il gruppo corrente.
Se un elemento non dispone di tutti i flag di stato specificati, la ricerca continua con l'elemento successivo.

Valore restituito

nessuno

Osservazioni

Si noti che i flag seguenti, per l'uso solo con Windows Vista, sono reciprocamente esclusivi di qualsiasi altro flag in uso: LVNI_PREVIOUS, LVNI_VISIBLEONLY, LVNI_SAMEGROUPONLY, LVNI_VISIBLEORDER, LVNI_DIRECTIONMASK e LVNI_STATEMASK.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commctrl.h

Vedi anche

LVM_GETNEXTITEM

Condividi tramite