LVM_GETNEXTITEMINDEX mensagem
Recupera o índice de um item em um controle de exibição de lista especificado que corresponde às propriedades especificadas e à relação com outro item. Envie essa mensagem explicitamente ou usando a macro ListView_GetNextItemIndex .
Parâmetros
-
wParam [in, out]
-
Um ponteiro para a estrutura LVITEMINDEX do item com o qual iniciar 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.
-
lParam
-
Especifica a relação com o item listado no parâmetro 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. - 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 um item que é ordenado antes do item especificado em 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. - 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 o valor a seguir: 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
Retornará TRUE se tiver êxito ou FALSE 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_PREVIOUS, 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 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|