macro ListView_GetNextItemIndex (commctrl.h)

  • Articolo

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

Sintassi

BOOL ListView_GetNextItemIndex(
  [in]      HWND        hwnd,
  [in, out] LVITEMINDEX *plvii,
            LPARAM      flags
);

Parametri

[in] hwnd

Tipo: HWND

Handle per il controllo 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 che corrisponde ai flag specificati. Il processo chiamante è responsabile dell'allocazione di questa struttura e dell'impostazione dei relativi membri.

flags

Tipo: LPARAM

Relazione con l'elemento specificato nel parametro plvii. Può trattarsi di una o una combinazione dei valori seguenti:

Valore Significato
Esegue ricerche in base all'indice.
LVNI_ALL
 Cerca un elemento successivo per indice, il valore predefinito.
Cerca in base alla relazione fisica con l'indice dell'elemento in cui deve iniziare la ricerca.
LVNI_ABOVE
 Cerca un elemento sopra l'elemento specificato.
LVNI_BELOW
 Cerca un elemento al di sotto dell'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 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 flag di stato con valore come indicato di seguito: 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: Cerca nel gruppo corrente.
Se per un elemento non sono impostati tutti i flag di stato specificati, la ricerca continua con l'elemento successivo.

Valore restituito

Tipo: BOOL

Restituisce TRUE in caso di esito positivo oppure FALSE in caso contrario.

Osservazioni

Si noti che i flag seguenti, per l'uso solo con Windows Vista, si escludono a vicenda da qualsiasi altro flag in uso: LVNI_PREVIOUS, LVNI_VISIBLEONLY, LVNI_SAMEGROUPONLY, LVNI_VISIBLEORDER, LVNI_DIRECTIONMASK e LVNI_STATEMASK.

Fabbisogno

Requisito Valore
client minimo supportato Windows Vista [solo app desktop]
server minimo supportato Windows Server 2008 [solo app desktop]
piattaforma di destinazione Finestre
intestazione commctrl.h

Vedere anche

LVM_GETNEXTITEM