TreeView_Expand 매크로(commctrl.h)

TreeView_Expand 매크로는 지정된 부모 항목(있는 경우)과 연결된 자식 항목 목록을 확장하거나 축소합니다. 이 매크로를 사용하거나 TVM_EXPAND 메시지를 명시적으로 보낼 수 있습니다.

구문

void TreeView_Expand(
   hwnd,
   hitem,
   code
);

매개 변수

hwnd

형식: HWND

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

hitem

형식: HTREEITEM

확장되거나 축소될 부모 항목에 대한 핸들입니다.

code

형식: UINT

작업 플래그. 가능한 값 목록은 TVM_EXPAND플래그 매개 변수에 대한 설명을 참조하세요.

반환 값

없음

설명

이미 확장된 노드를 확장하거나 이미 축소된 노드를 축소하는 작업은 성공한 작업으로 간주되며 매크로는 0이 아닌 값을 반환합니다. 자식이 없는 노드를 확장하거나 축소하려는 시도는 실패로 간주되며 반환 값은 0입니다.

항목이 TVM_EXPAND 메시지에 의해 처음 펼쳐지면 작업에서 TVN_ITEMEXPANDING 및 TVN_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 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	commctrl.h