CTreeCtrl::GetNextItem

Article
06/10/2015

Appelez cette fonction pour extraire l'élément d'arborescence qui a une relation spécifiée, indiqué par le paramètre d' nCode , à hItem.

HTREEITEM GetNextItem( 
   HTREEITEM hItem, 
   UINT nCode  
) const;

Paramètres

hItem
Handle d'un élément d'arborescence.
nCode
Une balise indiquant le type de relation à hItem. Cette balise peut avoir l'une des valeurs suivantes :
- TVGN_CARET extrait actuellement l'élément sélectionné.
- TVGN_CHILD récupère le premier élément enfant de l'élément spécifié par le paramètre d' hItem .
- TVGN_DROPHILITE extrait l'élément qui est la cible d'une opération de glisser-déplacer.
- TVGN_FIRSTVISIBLE récupère le premier élément visible.
- TVGN_LASTVISIBLE récupère le dernier élément développé dans l'arborescence. Cela ne récupère pas le dernier élément visible dans la fenêtre d'arborescence.
- TVGN_NEXT extrait l'élément frère.
- TVGN_NEXTVISIBLE extrait l'élément visible qui suit l'élément spécifié.
- TVGN_PARENT récupère le parent de l'élément spécifié.
- TVGN_PREVIOUS extrait l'élément frère précédent.
- TVGN_PREVIOUSVISIBLE récupère le premier élément visible qui précède l'élément spécifié.
- TVGN_ROOT récupère le premier élément enfant de l'élément racine dont l'élément spécifié est une partie.

Valeur de retour

Le handle de l'élément si l'opération a réussi ; sinon NULL.

Notes

Cette fonction retourne NULL si l'élément qui est extrait est le nœud racine de l'arborescence. Par exemple, si vous utilisez ce message avec la balise d' TVGN_PARENT sur un enfant de premier niveau de le nœud racine de l'arborescence, le message retourne NULL.

Exemple

Pour obtenir un exemple d'utilisation GetNextItem dans une boucle, consultez 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);
}