CTreeCtrl::GetNextItem

Articolo
02/19/2013

Chiamare la funzione per recuperare l'elemento della visualizzazione struttura ad albero contenente il rapporto specificata, indicato dal parametro nCode, a hItem.

HTREEITEM GetNextItem(
   HTREEITEM hItem,
   UINT nCode 
) const;

Parametri

hItem
Handle di un elemento albero.
nCode
Un flag che indica il tipo di relazione a hItem.Questo flag può essere uno dei seguenti valori:
- TVGN_CARET recupera l'elemento attualmente selezionato.
- TVGN_CHILD recupera il primo elemento figlio dell'elemento specificato dal parametro hItem.
- TVGN_DROPHILITE recupera l'elemento di destinazione un'operazione di trascinamento.
- TVGN_FIRSTVISIBLE recupera il primo elemento visibile.
- TVGN_LASTVISIBLE recupera l'ultimo elemento espanso nella struttura ad albero.Ciò non recupera l'ultimo elemento visibile nella finestra di visualizzazione struttura ad albero.
- TVGN_NEXT recupera l'elemento di pari livello.
- TVGN_NEXTVISIBLE recupera l'elemento visibile seguente dopo l'elemento specificato.
- TVGN_PARENT recupera il padre dell'elemento specificato.
- TVGN_PREVIOUS recupera l'elemento di pari livello precedente.
- TVGN_PREVIOUSVISIBLE recupera il primo elemento visibile che precede l'elemento specificato.
- TVGN_ROOT recupera il primo elemento figlio dell'elemento radice di cui l'elemento specificato è una parte.

Valore restituito

Gli handle dell'elemento successivo in caso di esito positivo; in caso contrario NULL.

Note

Questa funzione restituirà NULL se l'elemento che viene recuperato è il nodo radice della struttura ad albero.Ad esempio, se si utilizza questo messaggio con il flag TVGN_PARENT su un elemento figlio di primo livello del nodo radice della visualizzazione struttura ad albero, restituirà il messaggio NULL.

Esempio

Per un esempio di utilizzo GetNextItem in un ciclo, vedere 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);
}