TVM_GETNEXTITEM 메시지

  • 아티클

지정된 항목과 지정된 관계를 포함하는 트리 보기 항목을 검색합니다. 이 메시지를 명시적으로 보내거나 TreeView_GetNextItem 매크로를 사용하여 보낼 수 있습니다.

매개 변수

wParam

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

값 의미
TVGN_CARET
 현재 선택된 항목을 검색합니다. TreeView_GetSelection 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
TVGN_CHILD
 hitem 매개 변수로 지정된 항목의 첫 번째 자식 항목을 검색합니다. TreeView_GetChild 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
TVGN_DROPHILITE
 끌어서 놓기 작업의 대상인 항목을 검색합니다. TreeView_GetDropHilight 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
TVGN_FIRSTVISIBLE
 트리 뷰 창에 표시되는 첫 번째 항목을 검색합니다. TreeView_GetFirstVisible 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
TVGN_LASTVISIBLE
 버전 4.71. 트리에서 마지막으로 확장된 항목을 검색합니다. 트리 뷰 창에 표시되는 마지막 항목은 검색하지 않습니다. TreeView_GetLastVisible 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
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 매크로를 사용하여 이 메시지를 보낼 수 있습니다.

lParam

항목에 대한 핸들입니다.

반환 값

성공하면 항목에 대한 핸들을 반환합니다. 대부분의 경우 메시지는 NULL 값을 반환하여 오류를 나타냅니다. 자세한 내용은 설명 단원을 참조 하십시오.

설명

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

다음 관련 매크로 중 하나를 사용할 수도 있습니다.
TreeView_GetChild
TreeView_GetDropHilight
TreeView_GetFirstVisible
TreeView_GetLastVisible
TreeView_GetNextSibling
TreeView_GetNextVisible
TreeView_GetParent
TreeView_GetPrevSibling
TreeView_GetPrevVisible
TreeView_GetRoot
TreeView_GetSelection

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2003 [데스크톱 앱만 해당]
헤더
Commctrl.h