TreeView_Expand マクロ (commctrl.h)

TreeView_Expand マクロは、指定した親アイテムに関連付けられている子項目の一覧 (存在する場合) を展開または折りたたみします。 このマクロを使用することも、TVM_EXPAND メッセージを明示的に送信することもできます。

構文

BOOL TreeView_Expand(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

パラメーター

hwnd

型: HWND

ツリー ビュー コントロールへのハンドル。

hitem

型: HTREEITEM

展開または折りたたまれる親項目へのハンドル。

code

型: UINT

アクション フラグ。 使用可能な値の一覧については、TVM_EXPANDの wParam パラメーターの説明を参照してください。

戻り値

型: BOOL

操作が成功した場合は 0 以外、それ以外の場合は 0 を返します。

備考

既に展開されているノードを展開するか、既に折りたたまれているノードを折りたたむ操作は成功したと見なされ、マクロは 0 以外の値を返します。 子を持たないノードを展開または折りたたもうとすると、エラーと見なされ、戻り値は 0 になります。

アイテムが最初に TVM_EXPAND メッセージによって展開されると、アクションによって TVN_ITEMEXPANDING と TVN_ITEMEXPANDED 通知コードが生成され、アイテムの TVIS_EXPANDEDONCE 状態フラグが設定されます。 この状態フラグが設定されている限り、後続の TVM_EXPAND メッセージはTVN_ITEMEXPANDINGまたはTVN_ITEMEXPANDED通知を生成しません。 TVIS_EXPANDEDONCE 状態フラグをリセットするには、TVE_COLLAPSEフラグとTVE_COLLAPSERESET フラグが設定された TVM_EXPAND メッセージを送信する必要があります。 TVIS_EXPANDEDONCE を明示的に設定しようとすると、予期しない動作が発生します。

ツリービュー コントロールの所有者が、TVN_ITEMEXPANDING 通知に応答して操作を拒否すると、展開操作が失敗することがあります。

必要条件