Share via

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