TreeView_Expand マクロ (commctrl.h)

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

構文

void TreeView_Expand(
   hwnd,
   hitem,
   code
);

パラメーター

hwnd

種類: HWND

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

hitem

型: HTREEITEM

展開または折りたたまれる親項目を処理します。

code

型: UINT

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

戻り値

なし

解説

既に展開されているノードを展開する、または既に折りたたまれているノードを折りたたむ操作は成功したと見なされ、マクロは 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 通知に応答して操作を拒否した場合、展開操作が失敗する可能性があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	commctrl.h