messaggio LVM_GETNEXTITEM

Cerca un elemento della visualizzazione elenco con le proprietà specificate e contiene la relazione specificata con un elemento specificato. È possibile inviare questo messaggio in modo esplicito o utilizzando la macro ListView_GetNextItem .

Parametri

wParam

Indice dell'elemento con cui iniziare la ricerca oppure -1 per trovare il primo elemento corrispondente ai flag specificati. L'elemento specificato viene escluso dalla ricerca.

lParam

Specifica la relazione con l'elemento specificato in wParam. Può trattarsi di una o una combinazione dei valori seguenti:

Valore	Significato
Cerca per indice.
LVNI_ALL	Cerca un elemento successivo per indice, il valore predefinito.
LVNI_PREVIOUS	Windows Vista e versioni successive: Cerca un elemento ordinato prima dell'elemento specificato in wParam. 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 fondamentalmente la logica della ricerca eseguita dai messaggi LVM_GETNEXTITEM o LVM_GETNEXTITEMINDEX .
Cerca in base alla relazione fisica con l'indice dell'elemento in cui deve iniziare la ricerca.
LVNI_ABOVE	Cerca un elemento che si trova sopra l'elemento specificato.
LVNI_BELOW	Cerca un elemento sotto l'elemento specificato.
LVNI_TOLEFT	Cerca un elemento a sinistra dell'elemento specificato.
LVNI_TORIGHT	Cerca un elemento a destra dell'elemento specificato.
LVNI_DIRECTIONMASK	Windows Vista e versioni successive: Maschera di flag direzionale con valore come segue: 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 flag di stato LVIS_DROPHILITED impostato
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 di flag di stato con valore come indicato di seguito: LVNI_FOCUSED | LVNI_SELECTED | LVNI_CUT | LVNI_DROPHILITED.
Cerca per 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 per un elemento non sono impostati tutti i flag di stato specificati, la ricerca continua con l'elemento successivo.

Valore restituito

Restituisce l'indice dell'elemento successivo in caso di esito positivo o -1 in caso contrario.

Commenti

Si noti che i flag seguenti, per l'uso solo con Windows Vista, si escludono a vicenda qualsiasi altro flag in uso: 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 2003 [solo app desktop]
Intestazione	Commctrl.h