다음을 통해 공유

TreeView_GetNextItem 매크로(commctrl.h)

  • 아티클

지정된 항목과 지정된 관계를 갖는 트리 뷰 항목을 검색합니다. 이 매크로를 사용하거나, 아래에 설명된 TreeView_Get 매크로 중 하나를 사용하거나, TVM_GETNEXTITEM 메시지를 명시적으로 보낼 수 있습니다.

통사론

HTREEITEM TreeView_GetNextItem(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

매개 변수

hwnd

형식: HWND

트리 뷰 컨트롤에 대한 핸들입니다.

hitem

형식: HTREEITEM

항목에 대한 핸들입니다.

code

형식: UINT

검색할 항목을 지정하는 플래그입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
TVGN_CARET
 현재 선택한 항목을 검색합니다. TreeView_GetSelection 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
TVGN_CHILD
 hitem 매개 변수로 지정된 항목의 첫 번째 자식 항목을 검색합니다. TreeView_GetChild 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
TVGN_DROPHILITE
 끌어서 놓기 작업의 대상인 항목을 검색합니다. TreeView_GetDropHilight 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
TVGN_FIRSTVISIBLE
 표시되는 첫 번째 항목을 검색합니다. TreeView_GetFirstVisible 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
TVGN_NEXT
 다음 형제 항목을 검색합니다. TreeView_GetNextSibling 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
TVGN_NEXTSELECTED
 Windows Vista 이상. 선택한 다음 항목을 검색합니다. TreeView_GetNextSelected 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
TVGN_NEXTVISIBLE
 지정된 항목 다음에 표시되는 다음 항목을 검색합니다. 지정된 항목이 표시되어야 합니다. TVM_GETITEMRECT 메시지를 사용하여 항목이 표시되는지 여부를 확인합니다. TreeView_GetNextVisible 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
TVGN_PARENT
 지정된 항목의 부모를 검색합니다. TreeView_GetParent 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
TVGN_PREVIOUS
 이전 형제 항목을 검색합니다. TreeView_GetPrevSibling 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
TVGN_PREVIOUSVISIBLE
 지정된 항목 앞에 표시되는 첫 번째 항목을 검색합니다. 지정된 항목이 표시되어야 합니다. TVM_GETITEMRECT 메시지를 사용하여 항목이 표시되는지 여부를 확인합니다. TreeView_GetPrevVisible 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
TVGN_ROOT
 트리 뷰 컨트롤의 맨 위 또는 첫 번째 항목을 검색합니다. TreeView_GetRoot 매크로를 사용하여 이 메시지를 보낼 수 있습니다.

반환 값

형식: HTREEITEM

성공하면 항목에 대한 핸들을 반환합니다. 대부분의 경우 메시지는 오류를 나타내기 위해 NULL 값을 반환합니다. 자세한 내용은 설명 섹션을 참조하세요.

발언

검색되는 항목이 트리의 루트 노드인 경우 이 매크로는 NULL 반환합니다. 예를 들어 트리 뷰 루트 노드의 첫 번째 수준 자식에서 TVGN_PARENT 플래그와 함께 이 매크로를 사용하면 매크로는 NULL반환합니다.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 commctrl.h