Tree-View コントロールウィンドウのスタイル

[アーティクル]
06/13/2023

このセクションでは、ツリービューコントロールの作成時に使用されるウィンドウスタイルの一覧を示します。

定数	説明
TVS_CHECKBOXES	バージョン 4.70。ツリービューコントロール内の項目のチェックボックスを有効にします。チェックボックスは、画像がアイテムに関連付けられている場合にのみ表示されます。このスタイルに設定すると、コントロールは DrawFrameControl を効果的に使用して、2 つのイメージを含む状態イメージリストを作成および設定します。状態イメージ 1 はオフのボックスで、状態イメージ 2 はチェックボックスです。状態イメージを 0 に設定すると、チェックボックスが完全に削除されます。詳細については、「状態イメージインデックスの操作」を参照してください。バージョン 5.80。アイテムに画像が関連付けられていない場合でも、チェックボックスを表示します。このスタイルを使用してツリービューコントロールを作成すると、スタイルを削除することはできません。代わりに、コントロールを破棄し、その代わりに新しいコントロールを作成する必要があります。ツリービューコントロールを破棄しても、チェックボックスの状態イメージリストは破棄されません。明示的に破棄する必要があります。ツリービューコントロールに TVM_GETIMAGELIST メッセージを送信して、状態イメージリストへのハンドルを取得します。次に、 ImageList_Destroyを使用してイメージリストを破棄します。このスタイルを使用する場合は、ツリービューコントロールを作成した後、ツリーを設定する前に、 setWindowLong でTVS_CHECKBOXESスタイルを設定する必要があります。そうしないと、タイミングの問題に応じて、チェックボックスがオフになっている可能性があります。
TVS_DISABLEDRAGDROP	ツリービューコントロールがTVN_BEGINDRAG通知コードを送信できないようにします。
TVS_EDITLABELS	ユーザーがツリービュー項目のラベルを編集できるようにします。
TVS_FULLROWSELECT	バージョン 4.71。ツリービューで行全体を選択できるようにします。選択した項目の行全体が強調表示され、項目の行の任意の場所をクリックすると、その行が選択されます。このスタイルは、 TVS_HASLINES スタイルと組み合わせて使用することはできません。
TVS_HASBUTTONS	親項目の横にプラス (+) ボタンとマイナス (-) ボタンを表示します。ユーザーはボタンをクリックして、親アイテムの子項目の一覧を展開または折りたたみます。ツリービューのルートに項目があるボタンを含めるには、TVS_LINESATROOTも指定する必要があります。
TVS_HASLINES	行を使用して項目の階層を表示します。
TVS_INFOTIP	バージョン 4.71。 TVN_GETINFOTIP通知を送信してツールヒント情報を取得します。
TVS_LINESATROOT	行を使用して、ツリービューコントロールのルートにある項目をリンクします。 TVS_HASLINESも指定されていない場合、この値は無視されます。
TVS_NOHSCROLL	バージョン 5.80。コントロールの水平スクロールを無効にします。コントロールには水平スクロールバーは表示されません。
TVS_NONEVENHEIGHT	バージョン 4.71 TVM_SETITEMHEIGHT メッセージを使用して、アイテムの高さを奇数の高さに設定します。既定では、項目の高さは偶数の値である必要があります。
TVS_NOSCROLL	バージョン 4.71。コントロールの水平スクロールと垂直スクロールの両方を無効にします。コントロールにはスクロールバーは表示されません。
TVS_NOTOOLTIPS	バージョン 4.70。ヒントを無効にします。
TVS_RTLREADING	バージョン 4.70。テキストを右から左に表示します (RTL)。通常、ウィンドウにはテキストが左から右 (LTR) で表示されます。 Windows をミラー化して、RTL を読み取るヘブライ語やアラビア語などの言語を表示できます。通常、ツリービューのテキストは、親ウィンドウのテキストと同じ方向に表示されます。 TVS_RTLREADINGが設定されている場合、ツリービューのテキストは親ウィンドウのテキストとは反対の方向に読み取られます。
TVS_SHOWSELALWAYS	ツリービューコントロールがフォーカスを失ったときに、選択した項目を選択したままにします。
TVS_SINGLEEXPAND	バージョン 4.71。選択されている項目を展開し、選択されていない項目をツリービューの選択時に折りたたみます。選択した項目をマウスで 1 回クリックし、その項目を閉じた場合は展開されます。ユーザーが Ctrl キーを押しながら項目を選択した場合、選択されていない項目は折りたたまれません。バージョン 5.80。選択されている項目を展開し、選択されていない項目をツリービューの選択時に折りたたみます。ユーザーが Ctrl キーを押しながら項目を選択した場合、選択されていない項目は折りたたまれません。
TVS_TRACKSELECT	バージョン 4.70。ツリービューコントロールでホットトラッキングを有効にします。

必要条件

要件	値
ヘッダー	CommCtrl.h