다음을 통해 공유


TVM_DELETEITEM 메시지

트리 뷰 컨트롤에서 항목과 모든 자식을 제거합니다. 이 메시지를 명시적으로 보내거나 TreeView_DeleteItem 매크로를 사용하여 보낼 수 있습니다.

매개 변수

wParam

0이어야 합니다.

lParam

삭제할 항목에 대한 HTREEITEM 핸들입니다. lParam이 TVI_ROOT 또는 NULL로 설정되면 모든 항목이 삭제됩니다. TreeView_DeleteAllItems 매크로를 사용하여 모든 항목을 삭제할 수도 있습니다.

반환 값

성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다.

설명

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

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

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

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

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

요구 사항

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