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 |