mensaje de LVM_GETNEXTITEM

  • Artículo

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