mensaje de LVM_GETNEXTITEM

Busca un elemento de vista de lista que tenga las propiedades especificadas y lleve la relación especificada con un elemento especificado. Puede enviar este mensaje explícitamente o mediante la macro ListView_GetNextItem .

Parámetros

wParam

Índice del elemento con el que se va a iniciar la búsqueda o -1 para buscar el primer elemento que coincida con las marcas especificadas. El propio elemento especificado se excluye de la búsqueda.

lParam

Especifica la relación con el elemento especificado en wParam. Puede ser una o una combinación de los valores siguientes:

Valor	Significado
Busca por índice.
LVNI_ALL	Busca un elemento posterior por índice, el valor predeterminado.
LVNI_PREVIOUS	Windows Vista y versiones posteriores: Busca un elemento ordenado antes del elemento especificado en wParam. La marca LVNI_PREVIOUS no es direccional (LVNI_ABOVE encontrará el elemento situado anteriormente, mientras que LVNI_PREVIOUS encontrará el elemento ordenado antes). La marca LVNI_PREVIOUS invierte básicamente la lógica de la búsqueda realizada por los mensajes LVM_GETNEXTITEM o LVM_GETNEXTITEMINDEX .
Busca por relación física con el índice del elemento donde se va a comenzar la búsqueda.
LVNI_ABOVE	Busca un elemento situado encima del elemento especificado.
LVNI_BELOW	Busca un elemento situado debajo del elemento especificado.
LVNI_TOLEFT	Busca un elemento a la izquierda del elemento especificado.
LVNI_TORIGHT	Busca un elemento a la derecha del elemento especificado.
LVNI_DIRECTIONMASK	Windows Vista y versiones posteriores: Máscara de marca direccional con el valor siguiente: LVNI_ABOVE | LVNI_BELOW | LVNI_TOLEFT | LVNI_TORIGHT.
El estado del elemento que se va a buscar se puede especificar con una o una combinación de los valores siguientes:
LVNI_CUT	El elemento tiene establecida la marca de estado LVIS_CUT .
LVNI_DROPHILITED	El elemento tiene establecida la marca de estado LVIS_DROPHILITED
LVNI_FOCUSED	El elemento tiene establecida la marca de estado LVIS_FOCUSED .
LVNI_SELECTED	El elemento tiene establecida la marca de estado LVIS_SELECTED .
LVNI_STATEMASK	Windows Vista y versiones posteriores: Máscara de marca de estado con el valor siguiente: LVNI_FOCUSED | LVNI_SELECTED | LVNI_CUT | LVNI_DROPHILITED.
Búsquedas por apariencia de elementos o por grupo
LVNI_VISIBLEORDER	Windows Vista y versiones posteriores: Busque el orden visible.
LVNI_VISIBLEONLY	Windows Vista y versiones posteriores: Busque los elementos visibles.
LVNI_SAMEGROUPONLY	Windows Vista y versiones posteriores: Busque en el grupo actual.
Si un elemento no tiene todas las marcas de estado especificadas establecidas, la búsqueda continúa con el siguiente elemento.

Valor devuelto

Devuelve el índice del siguiente elemento si se ejecuta correctamente o -1 de lo contrario.

Observaciones

Tenga en cuenta que las marcas siguientes, para su uso solo con Windows Vista, son mutuamente excluyentes de cualquier otra marca en uso: LVNI_VISIBLEONLY, LVNI_SAMEGROUPONLY, LVNI_VISIBLEORDER, LVNI_DIRECTIONMASK y LVNI_STATEMASK.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	Commctrl.h