다음을 통해 공유


TVM_EXPAND 메시지

TVM_EXPAND 메시지는 지정된 부모 항목(있는 경우)과 연결된 자식 항목의 목록을 펼치거나 접습니다. 이 메시지를 명시적으로 보내거나, TreeView_Expand 매크로를 사용하여 보낼 수 있습니다.

매개 변수

wParam

작업 플래그로, 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

의미
TVE_COLLAPSE
목록을 접습니다.
TVE_COLLAPSERESET
목록을 접고 자식 항목을 제거합니다. TVIS_EXPANDEDONCE 상태 플래그가 다시 설정됩니다. 이 플래그는 TVE_COLLAPSE 플래그와 함께 사용해야 합니다.
TVE_EXPAND
목록을 펼칩니다.
TVE_EXPANDPARTIAL
버전 4.70. 목록을 부분적으로 펼칩니다. 이 상태에서 자식 항목이 표시되고, 확장할 수 있음을 나타내는 부모 항목의 더하기 기호(+)가 표시됩니다. 이 플래그는 TVE_EXPAND 플래그와 함께 사용해야 합니다.
TVE_TOGGLE
목록이 펼쳐진 경우 목록을 접고, 목록이 접힌 경우 목록을 펼칩니다.

lParam

펼치거나 접을 부모 항목에 대한 핸들입니다.

반환 값

작업에 성공하면 0이 아닌 값을 반환하고, 그렇지 않으면 0을 반환합니다.

설명

이미 펼쳐진 노드를 펼치는 것은 성공한 작업으로 간주되며 SendMessage가 0이 아닌 값을 반환합니다. 노드를 접을 때 노드가 이미 접혀 있으면 0을 반환하고, 그렇지 않으면 0이 아닌 값을 반환합니다. 자식이 없는 노드를 펼치거나 접으려는 시도는 실패로 간주되며 SendMessage가 0을 반환합니다.

항목이 TVM_EXPAND 메시지에 의해 처음 펼쳐지면 작업에서 TVN_ITEMEXPANDINGTVN_ITEMEXPANDED 알림 코드를 생성하고 항목의 TVIS_EXPANDEDONCE 상태 플래그가 설정됩니다. 이 상태 플래그가 설정된 상태로 유지되는 한, 후속 TVM_EXPAND 메시지가 TVN_ITEMEXPANDING 또는 TVN_ITEMEXPANDED 알림을 생성하지 않습니다. TVIS_EXPANDEDONCE 상태 플래그를 다시 설정하려면 TVE_COLLAPSE 및 TVE_COLLAPSERESET 플래그가 설정된 TVM_EXPAND 메시지를 보내야 합니다. TVIS_EXPANDEDONCE를 명시적으로 설정하려고 하면 예기치 않은 동작이 발생합니다.

트리 뷰 컨트롤의 소유자가 TVN_ITEMEXPANDING 알림에 대한 응답으로 작업을 거부하는 경우 펼치기 작업에 실패할 수 있습니다.

요구 사항

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