commctrl.h

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:

ValorSignificado
Búsqueda por índice.
LVNI_ALLBusca el siguiente ítem por índice, el valor por defecto.
LVNI_PREVIOUSWindows 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_ABOVEBusca un ítem que esté por encima del especificado.
LVNI_BELOWBusca un ítem que esté por debajo del especificado.
LVNI_TOLEFTBusca un ítem que esté a la izquierda del especificado.
LVNI_TORIGHTBusca un ítem que esté a la derecha del especificado.
LVNI_DIRECTIONMASKWindows 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_CUTEl ítem tiene asignada la bandera de estado LVIS_CUT.
LVNI_DROPHILITEDEl ítem tiene asignada la bandera de estado LVIS_DROPHILITED.
LVNI_FOCUSEDEl ítem tiene asignada la bandera de estado LVIS_FOCUSED.
LVNI_SELECTEDEl ítem tiene asignada la bandera de estado LVIS_SELECTED.
LVNI_STATEMASKWindows 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_VISIBLEORDERWindows Vista y posteriores: Buscar en el orden visible.
LVNI_VISIBLEONLYWindows Vista y posteriores: Buscar en ítems visibles.
LVNI_SAMEGROUPONLYWindows 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.