TreeView_DeleteItem 매크로(commctrl.h)

트리 뷰 컨트롤에서 항목과 모든 자식을 제거합니다. TVM_DELETEITEM 메시지를 명시적으로 보낼 수도 있습니다.

구문

void TreeView_DeleteItem(
   hwnd,
   hitem
);

매개 변수

hwnd

형식: HWND

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

hitem

형식: HTREEITEM

삭제할 항목에 대한 HTREEITEM 핸들입니다. hitem이 TVI_ROOT 설정되면 트리 뷰 컨트롤에서 모든 항목이 삭제됩니다. TreeView_DeleteAllItems 매크로를 사용하여 모든 항목을 삭제할 수도 있습니다.

반환 값

없음

설명

TVN_SELCHANGING과 같은 알림에 대한 응답으로 항목을 삭제하는 것은 안전하지 않습니다.

항목이 삭제되면 핸들이 유효하지 않으며 사용할 수 없습니다.

부모 창은 각 항목이 제거될 때 TVN_DELETEITEM 알림 코드를 받습니다.

항목 레이블을 편집 중인 경우 편집 작업이 취소되고 부모 창에 TVN_ENDLABELEDIT 알림 코드가 수신됩니다.

TVS_NOSCROLL 스타일이 있는 트리 뷰 컨트롤에서 모든 항목을 삭제하면 이후에 추가된 항목이 제대로 표시되지 않을 수 있습니다. 자세한 내용은 TreeView_DeleteAllItems를 참조하세요.

요구 사항

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