Macro ListView_GetNextItemIndex (commctrl.h)
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
void ListView_GetNextItemIndex(
[in] hwnd,
[in, out] plvii,
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 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 um item subsequente por índice, o valor padrão. |
|
|
|
Pesquisa um item acima do item especificado. |
|
Pesquisa um item abaixo do item especificado. |
|
Pesquisa um item à esquerda do item especificado. |
|
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 encontrará 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. |
|
Pesquisa um item à direita do item especificado. |
|
Windows Vista e posterior: Uma máscara de sinalizador direcional com valor da seguinte maneira: LVNI_ABOVE | LVNI_BELOW | LVNI_TOLEFT | LVNI_TORIGHT. |
|
|
|
O item tem o sinalizador de estado LVIS_CUT definido. |
|
O item tem o sinalizador de estado LVIS_DROPHILITED definido |
|
O item tem o sinalizador de estado LVIS_FOCUSED definido. |
|
O item tem o sinalizador de estado LVIS_SELECTED definido. |
|
Windows Vista e posterior: Uma máscara de sinalizador de estado com o valor a seguir: LVNI_FOCUSED | LVNI_SELECTED | LVNI_CUT | LVNI_DROPHILITED. |
|
|
|
Windows Vista e posterior: Pesquise a ordem visível. |
|
Windows Vista e posterior: Pesquise os itens visíveis. |
|
Windows Vista e posterior: Pesquise o grupo atual. |
|
Retornar valor
Nenhum
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] |
Plataforma de Destino | Windows |
Cabeçalho | commctrl.h |