Partilhar via


CListCtrl::GetNextItem

Procura um item de exibição de lista que tenha as propriedades específicas e que carrega a relação a um item especificado dado.

int GetNextItem(
   int nItem,
   int nFlags 
) const;

Parâmetros

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

  • nFlags
    Relação geométrica de item solicitado ao item especificado, e o estado do item solicitado.O relacionamento geométrica pode ser um de esses valores:

    • LVNI_ABOVE procura por um item que está acima do item especificado.

    • LVNI_ALL procura por um item subseqüente pelo índice (o valor padrão).

    • LVNI_BELOW procura por um item que está sob o item especificado.

    • LVNI_TOLEFT procura por um item à esquerda do item especificado.

    • LVNI_TORIGHT procura por um item à direita do item especificado.

  • O estado pode ser zero, ou pode ser um ou mais de esses valores:

    • LVNI_DROPHILITED o item tem a opção de estado de LVIS_DROPHILITED definido.

    • LVNI_FOCUSED o item tem a opção de estado de LVIS_FOCUSED definido.

    • LVNI_SELECTED o item tem a opção de estado de LVIS_SELECTED definido.

    Se um item não tem todos os sinalizadores especificados de estado definidos, a pesquisa continua com o próximo item.

Valor de retorno

O índice do item seguir se com êxito ou -1, caso contrário.

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe de CListCtrl

Gráfico de hierarquia

CListCtrl::GetItem