Compartilhar via


LVM_GETNEXTITEM mensagem

Pesquisa um item de exibição de lista que tem as propriedades especificadas e carrega a relação especificada com um item especificado. Você pode enviar essa mensagem explicitamente ou usando a macro ListView_GetNextItem .

Parâmetros

wParam

Índice do item com o qual iniciar a pesquisa ou -1 para localizar o primeiro item que corresponde aos sinalizadores especificados. O item especificado é excluído da pesquisa.

lParam

Especifica a relação com o item especificado em wParam. 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.
LVNI_PREVIOUS
Windows Vista e posterior: Pesquisa um item que é ordenado antes do item especificado no wParam. O sinalizador LVNI_PREVIOUS não é direcional (LVNI_ABOVE localizará o item posicionado acima, enquanto LVNI_PREVIOUS encontrará o item ordenado antes.) O sinalizador LVNI_PREVIOUS basicamente inverte a lógica da pesquisa executada pelas mensagens LVM_GETNEXTITEM ou LVM_GETNEXTITEMINDEX .
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_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 encontrado 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: Pesquise a ordem visível.
LVNI_VISIBLEONLY
Windows Vista e posterior: Pesquise os itens visíveis.
LVNI_SAMEGROUPONLY
Windows Vista e posterior: Pesquise 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 retornado

Retorna o índice do próximo item se tiver êxito ou -1 caso contrário.

Comentários

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

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Commctrl.h