Compartilhar via


ListView_GetNextItem macro (commctrl.h)

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

Sintaxe

int ListView_GetNextItem(
   HWND hwnd,
   int  i,
   UINT flags
);

Parâmetros

hwnd

Tipo: HWND

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

i

Tipo: int

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

flags

Tipo: UINT

A relação geométrica do item solicitado para o item especificado e, se especificado, o estado do item solicitado. Para obter uma lista de valores possíveis, consulte a descrição do parâmetro lParam na mensagem LVM_GETNEXTITEM. 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: int

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

Requisitos

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