TreeView_Expand 매크로(commctrl.h)

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

통사론

BOOL TreeView_Expand(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

매개 변수

hwnd

형식: HWND

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

hitem

형식: HTREEITEM

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

code

형식: UINT

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

반환 값

형식: BOOL

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

발언

이미 확장된 노드를 확장하거나 이미 축소된 노드를 축소하는 작업은 성공한 작업으로 간주되며 매크로는 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 명시적으로 설정하려고 하면 예기치 않은 동작이 발생합니다.

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

요구 사항

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