CTreeCtrl::GetNextItem

Artigo
02/25/2013

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

HTREEITEM GetNextItem(
   HTREEITEM hItem,
   UINT nCode 
) const;

Parâmetros

hItem
Identificador de um item de árvore.
nCode
Um sinalizador que indica o tipo de relação a hItem.Este sinalizador pode ser um dos seguintes valores:
- TVGN_CARET recupera o item atualmente selecionado.
- TVGN_CHILD retorna o primeiro item filho do item especificado pelo parâmetro de hItem .
- TVGN_DROPHILITE recupera o item que é o destino de uma operação de arrastar e soltar.
- TVGN_FIRSTVISIBLE retorna o primeiro item visível.
- TVGN_LASTVISIBLE recupera o item expandido último na árvore.Isso não recupera o último item visível na janela de exibição de árvore.
- TVGN_NEXT recuperar o próximo item irmãos.
- TVGN_NEXTVISIBLE recupera o item visível seguir após o item especificado.
- TVGN_PARENT recupera o pai do item especificado.
- TVGN_PREVIOUS recupera o item anterior irmãos.
- TVGN_PREVIOUSVISIBLE retorna o primeiro item visível antes do item especificado.
- TVGN_ROOT retorna o primeiro item filho do item raiz de que o item especificado é uma parte.

Valor de retorno

O identificador do próximo item se com êxito; se não 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 esta mensagem com o sinalizador de TVGN_PARENT em um filho do primeiro nível do nó raiz de modo de exibição de árvore, a mensagem retornará NULO.

Exemplo

Para um exemplo de como usar GetNextItem em um loop, consulte 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);
}