Mensaje LVM_GETNEXTITEM

Definición

LVM_GETNEXTITEM
    i=(WPARAM)(int)wParam
   flags=(LPARAM)(UINT)lParam

Busca un ítem en el list-view que tenga las propiedades especificadas y guarde la relación especificada con un ítem determinado. Se puede enviar este mensaje explícitamente o bien usar la macro ListView_GetNextItem.

Descripción

i

El índice del ítem desde el que comenzar la búsqueda, o -1 para localizar el primer ítem que coincida con las banderas especificadas. El ítem especificado mismo es excluido de la búsqueda.

flags

Especifica la relación con el ítem especificado en wParam. 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.