Macro ListView_GetNextItemIndex (commctrl.h)

  • Artículo

Obtiene el índice del elemento en un control de vista de lista determinado que tiene las propiedades y la relación especificadas con otro elemento específico. Use esta macro o envíe explícitamente el mensaje LVM_GETNEXTITEMINDEX .

Sintaxis

void ListView_GetNextItemIndex(
  [in]       hwnd,
  [in, out]  plvii,
             flags
);

Parámetros

[in] hwnd

Tipo: HWND

Identificador del control de vista de lista.

[in, out] plvii

Tipo: LVITEMINDEX*

Puntero a la estructura LVITEMINDEX con la que el elemento inicia la búsqueda, o -1 para buscar el primer elemento que coincide con las marcas especificadas. El proceso de llamada es responsable de asignar esta estructura y establecer sus miembros.

flags

Tipo: LPARAM

Relación con el elemento especificado en el parámetro plvii. 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.
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_PREVIOUS
 Windows Vista y versiones posteriores: Busca el elemento anterior al elemento especificado. 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 esencialmente la lógica de la búsqueda realizada a través de los mensajes LVM_GETNEXTITEM o LVM_GETNEXTITEMINDEX.
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.
Busca 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

None

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_PREVIOUS, 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 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado commctrl.h

Consulte también

LVM_GETNEXTITEM