Macro ListView_GetNextItemIndex

Obtiene el índice del ítem en un control list-view determinado que tiene las propiedades especificadas y una relación con otro ítem especificado. Se puede usar esta macro o enviar el mensaje LVM_GETNEXTITEMINDEX explícitamente.

Definición

int ListView_GetNextItemIndex(
    HWND hwnd,
    LVITEMINDEX* plvii,
    LPARAM flags
);

Descripción

hwnd

Un manipulador del control list-view.

plvii

Un puntero a una estructura LVITEMINDEX con el ítem donde empezar la búsqueda, o -1 para encontrar el primer ítem que coincida con las banderas especificadas. El proceso que invoca es el responsable de obtener memoria para esta estructura y de asignar sus miembros.

flags

Especifica la relación con el ítem especificado en plvii. Puede ser uno o una combinación de los siguientes valores:

Valor	Significado
Búsqueda por índice.
LVNI_ALL	Busca el siguiente ítem por índice, el valor por defecto.
LVNI_PREVIOUS	Windows Vista y siguientes: Busca un ítem que esté ordenado antes del ítem especificado en wParam. La bandera LVNI_PREVIOUS no es direccional (LVNI_ABOVE encontrará el ítem colocado encima, mientras LVNI_PREVIOUS encontrará el ítem ordenado antes.) la bandera LVNI_PREVIOUS básicamente invierta la lógica de la búsqueda realizada por los mensajes LVM_GETNEXTITEM o LVM_GETNEXTITEMINDEX.
Búsqueda por relación física con el índice del ítem en el que comienza la búsqueda.
LVNI_ABOVE	Busca un ítem que esté por encima del especificado.
LVNI_BELOW	Busca un ítem que esté por debajo del especificado.
LVNI_TOLEFT	Busca un ítem que esté a la izquierda del especificado.
LVNI_TORIGHT	Busca un ítem que esté a la derecha del especificado.
LVNI_DIRECTIONMASK	Windows Vista y posteriores: Una máscara de banderas direccional con el siguiente valor: LVNI_ABOVE | LVNI_BELOW | LVNI_TOLEFT | LVNI_TORIGHT.
El estado del ítem a encontrar puede ser especificado por uno o una combinación de los siguientes valores:
LVNI_CUT	El ítem tiene asignada la bandera de estado LVIS_CUT.
LVNI_DROPHILITED	El ítem tiene asignada la bandera de estado LVIS_DROPHILITED.
LVNI_FOCUSED	El ítem tiene asignada la bandera de estado LVIS_FOCUSED.
LVNI_SELECTED	El ítem tiene asignada la bandera de estado LVIS_SELECTED.
LVNI_STATEMASK	Windows Vista y posteriores: Una máscara de banderas de estado con el siguiente valor: LVNI_FOCUSED | LVNI_SELECTED | LVNI_CUT | LVNI_DROPHILITED.
Búsqueda por apariencia de ítems o por grupo.
LVNI_VISIBLEORDER	Windows Vista y posteriores: Buscar en el orden visible.
LVNI_VISIBLEONLY	Windows Vista y posteriores: Buscar en ítems visibles.
LVNI_SAMEGROUPONLY	Windows Vista y posteriores: Buscar en el grupo actual.
Si un ítem no tiene asignados todas las banderas de estado especificadas, la búsqueda continúa con el siguiente ítem.

Valor de retorno

Devuelve el índice del siguiente ítem si tiene éxito, o -1 en caso contrario.

Observaciones

Hay que tener en cuenta que las siguientes banderas, para usarse solo con Windows Vista, son mutuamente excluyentes con cualquier otra bandera en uso: LVNI_VISIBLEONLY, LVNI_SAMEGROUPONLY, LVNI_VISIBLEORDER, LVNI_DIRECTIONMASK y LVNI_STATEMASK.