CTreeCtrl::GetNextItem

Artigo
08/25/2010

Chamar esta função para recuperar o item de modo de exibição de árvore que tenha a relação especificada, indicada pelo nCode parâmetro, para hItem.

HTREEITEM GetNextItem(
   HTREEITEM hItem,
   UINT nCode 
) const;

Parâmetros

hItem
Identificador de um item da árvore.
nCode
Um sinalizar que indica o tipo de relação para hItem. Este sinalizar pode ser um dos seguintes valores:
- TVGN_CARET Recupera o item selecionado no momento.
- TVGN_CHILD Recupera o primeiro item de filhos do item especificado pela hItem parâmetro.
- TVGN_DROPHILITE Recupera o item é o destino de uma operação de do tipo arrastar e soltar.
- TVGN_FIRSTVISIBLE Recupera o primeiro item visível.
- TVGN_LASTVISIBLE Recupera o último item expandido da árvore. Isso não recupera o último item visível da janela do modo de exibição de árvore.
- TVGN_NEXT Recupera o próximo item irmão.
- TVGN_NEXTVISIBLE Recupera o próximo item visível que segue o item especificado.
- TVGN_PARENT Recupera o pai do item especificado.
- TVGN_PREVIOUS Recupera o item irmão anterior.
- TVGN_PREVIOUSVISIBLE Recupera o primeiro item visível que precede o item especificado.
- TVGN_ROOT Recupera o primeiro item de filhos do item raiz das quais o item especificado é uma parte.

Valor de retorno

O identificador do próximo item se tiver êxito; caso contrário, NULO.

Comentários

Esta função retornará NULO se o item que está sendo recuperado é o nó raiz da árvore.Por exemplo, se você usar essa mensagem com o TVGN_PARENT sinalizar em um filho de primeiro nível do nó de raiz da exibição em árvore, retornará a mensagem NULO.

Exemplo

Para obter um exemplo do uso de GetNextItem em um loop, ver CTreeCtrl::DeleteItem.

// find the currently selected item
HTREEITEM hCurSel = m_TreeCtrl.GetNextItem(TVI_ROOT, TVGN_CARET);

// report it to the user
if (hCurSel == NULL)
{
   AfxMessageBox(_T("There is no selected item"));
}
else
{
   CString str;
   str.Format(_T("The currently selected item is \"%s\""),
      (LPCTSTR)m_TreeCtrl.GetItemText(hCurSel));
   AfxMessageBox((LPCTSTR)str);
}