CTreeCtrl::GetNextItem

아티클
02/21/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);
}