ListView_GetNextItemIndex macro (commctrl.h)

Artigo
10/24/2024

Obtém o índice do item em um controle de exibição de lista específico que tem as propriedades especificadas e a relação com outro item específico. Use essa macro ou envie a mensagem LVM_GETNEXTITEMINDEX explicitamente.

Sintaxe

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

Parâmetros

[in] hwnd

Tipo: HWND

Um identificador para o controle de exibição de lista.

[in, out] plvii

Tipo: * LVITEMINDEX

Um ponteiro para a estrutura de LVITEMINDEX com a qual o item inicia a pesquisa ou -1 para localizar o primeiro item que corresponde aos sinalizadores especificados. O processo de chamada é responsável por alocar essa estrutura e definir seus membros.

flags

Tipo: LPARAM

A relação com o item especificado no parâmetro plvii . Isso pode ser uma ou uma combinação dos seguintes valores:

Valor	Significado
Pesquisa por índice.
LVNI_ALL	Pesquisa um item subsequente por índice, o valor padrão.
Pesquisa por relação física com o índice do item em que a pesquisa deve começar.
LVNI_ABOVE	Pesquisa um item acima do item especificado.
LVNI_BELOW	Pesquisa um item abaixo do item especificado.
LVNI_TOLEFT	Pesquisa um item à esquerda do item especificado.
LVNI_PREVIOUS	Windows Vista e posterior: pesquisa o item anterior ao item especificado. O sinalizador LVNI_PREVIOUS não é direcional (LVNI_ABOVE localizará o item posicionado acima, enquanto LVNI_PREVIOUS localizará o item ordenado antes.) O sinalizador LVNI_PREVIOUS essencialmente inverte a lógica da pesquisa executada por meio das mensagens LVM_GETNEXTITEM ou LVM_GETNEXTITEMINDEX.
LVNI_TORIGHT	Pesquisa um item à direita do item especificado.
LVNI_DIRECTIONMASK	Windows Vista e posterior: Uma máscara de sinalizador direcional com valor da seguinte maneira: LVNI_ABOVE \| LVNI_BELOW \| LVNI_TOLEFT \| LVNI_TORIGHT.
O estado do item a ser localizado pode ser especificado com um ou uma combinação dos seguintes valores:
LVNI_CUT	O item tem o sinalizador de estado LVIS_CUT definido.
LVNI_DROPHILITED	O item tem o sinalizador de estado LVIS_DROPHILITED definido
LVNI_FOCUSED	O item tem o sinalizador de estado LVIS_FOCUSED definido.
LVNI_SELECTED	O item tem o sinalizador de estado LVIS_SELECTED definido.
LVNI_STATEMASK	Windows Vista e posterior: Uma máscara de sinalizador de estado com valor da seguinte maneira: LVNI_FOCUSED \| LVNI_SELECTED \| LVNI_CUT \| LVNI_DROPHILITED.
Pesquisa por aparência de itens ou por grupo.
LVNI_VISIBLEORDER	Windows Vista e posterior: Pesquisar a ordem visível.
LVNI_VISIBLEONLY	Windows Vista e posterior: Pesquisar os itens visíveis.
LVNI_SAMEGROUPONLY	Windows Vista e posterior: Pesquisar o grupo atual.
Se um item não tiver todos os sinalizadores de estado especificados definidos, a pesquisa continuará com o próximo item.

Valor de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

Observe que os sinalizadores a seguir, para uso somente com o Windows Vista, são mutuamente exclusivos de quaisquer outros sinalizadores em uso: LVNI_PREVIOUS, LVNI_VISIBLEONLY, LVNI_SAMEGROUPONLY, LVNI_VISIBLEORDER, LVNI_DIRECTIONMASK e LVNI_STATEMASK.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h

Consulte também

LVM_GETNEXTITEM

Compartilhar via