CTreeCtrl::GetNextItem

项目
03/01/2013

调用该函数检索具有指定的关系的树视图项目，表示由 nCode 参数，对 hItem。

HTREEITEM GetNextItem(
   HTREEITEM hItem,
   UINT nCode 
) const;

参数

hItem
树项的句柄。
nCode
指示关系的类型。hItem的标志。此标志可为下列值之一：
- TVGN_CARET 检索当前选定的项。
- TVGN_CHILD 检索 hItem 参数指定的项目的第一个子项。
- TVGN_DROPHILITE 检索是拖放操作的目标的项目。
- TVGN_FIRSTVISIBLE 检索第一个可见项。
- TVGN_LASTVISIBLE 检索在树的最后展开项。这不检索最后一项显示在树视图窗口。
- TVGN_NEXT 检索下一个同级项目。
- TVGN_NEXTVISIBLE 检索下一个指定项目的下一个可见项。
- TVGN_PARENT 检索具有指定项的父级。
- TVGN_PREVIOUS 检索同级项目。
- TVGN_PREVIOUSVISIBLE 检索前面放置一个指定项目的第一个可见项。
- TVGN_ROOT 检索具有指定的项目是分部项目根的第一个子项。

返回值

下一项的句柄，如果成功;否则 NULL。

备注

如果检索的项目是一个树的根节点，此函数将返回 NULL。例如，因此，如果您使用 TVGN_PARENT 标志的此消息在树视图的根节点的第一层的子级，消息时返回 NULL。

示例

有关使用的示例在循环中 GetNextItem，请参见 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);
}