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을 반환합니다.
다음 관련 매크로 중 하나를 사용할 수도 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| 헤더 |
|