다음을 통해 공유


TreeView_DeleteItem 매크로(commctrl.h)

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

통사론

BOOL TreeView_DeleteItem(
   HWND      hwnd,
   HTREEITEM hitem
);

매개 변수

hwnd

형식: HWND

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

hitem

형식: HTREEITEM

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

반환 값

형식: BOOL

성공하면 TRUE 반환하거나, 그렇지 않으면 FALSE .

발언

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

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

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

항목 레이블을 편집하는 경우 편집 작업이 취소되고 부모 창에서 TVN_ENDLABELEDIT 알림 코드를 받습니다.

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

요구 사항

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