messaggio LVM_GETNEXTITEMINDEX
Recupera l'indice di un elemento in un controllo di visualizzazione elenco specificato che corrisponde alle proprietà specificate e alla relazione a un altro elemento. Inviare questo messaggio in modo esplicito o usando la macro ListView_GetNextItemIndex .
Parametri
-
wParam [in, out]
-
Puntatore alla struttura LVITEMINDEX per l'elemento con cui iniziare 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.
-
lParam
-
Specifica la relazione con l'elemento elencato nel parametro wParam. 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 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. - 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
Restituisce TRUE se ha esito positivo o FALSE in caso contrario.
Commenti
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] |
Intestazione |
|