TVM_EXPAND メッセージ

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

パラメーター

wParam

アクション フラグ。 このパラメーターには、次の値のうち 1 つ以上を指定できます。

値	説明
TVE_COLLAPSE	リストを折りたたむ。
TVE_COLLAPSERESET	リストを折りたたみ、子項目を削除します。 TVIS_EXPANDEDONCE状態フラグがリセットされます。 このフラグは、TVE_COLLAPSE フラグと共に使用する必要があります。
TVE_EXPAND	リストを展開します。
TVE_EXPANDPARTIAL	バージョン 4.70。 リストを部分的に展開します。 この状態では、子項目が表示され、親項目のプラス記号 (+) が表示され、展開できることを示します。 このフラグは、TVE_EXPAND フラグと組み合わせて使用する必要があります。
TVE_TOGGLE	リストが展開されている場合は折りたたみ、折りたたまれている場合は展開します。

lParam

展開または折りたたみを行う親アイテムを処理します。

戻り値

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

解説

既に展開されているノードの展開は正常な操作と見なされ、 SendMessage は 0 以外の値を返します。 ノードが既に折りたたまれている場合、ノードを折りたたむと 0 が返されます。それ以外の場合は 0 以外の値を返します。 子を持たないノードを展開または折りたたもうとすると、エラーと見なされ、 SendMessage は 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 [デスクトップ アプリのみ]
ヘッダー	Commctrl.h