CTreeCtrl::GetNextItem

發行項
02/28/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);
}