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

BOOL ListView_GetNextItemIndex(
  [in]      HWND        hwnd,
  [in, out] LVITEMINDEX *plvii,
            LPARAM      flags
);

Parámetros

[in] hwnd

Tipo: HWND

Identificador del control list-view.

[in, out] plvii

Tipo: * LVITEMINDEX

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

flags

Tipo: LPARAM de

Relación con el elemento especificado en el parámetro plvii. Puede ser una o una combinación de los siguientes valores:

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 que esté 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 colocado 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 siguientes valores:
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: Buscar en el orden visible.
LVNI_VISIBLEONLY
 Windows Vista y versiones posteriores: Buscar los elementos visibles.
LVNI_SAMEGROUPONLY
 Windows Vista y versiones posteriores: Buscar 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

Tipo: BOOL de

Devuelve TRUE si se ejecuta correctamente o FALSE 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_PREVIOUS, LVNI_VISIBLEONLY, LVNI_SAMEGROUPONLY, LVNI_VISIBLEORDER, LVNI_DIRECTIONMASK y LVNI_STATEMASK.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de commctrl.h

Consulte también

LVM_GETNEXTITEM