Tree-View コントロールについて

[アーティクル]
05/11/2022

ツリービューコントロールは、ドキュメント内の見出し、インデックス内のエントリ、ディスク上のファイルとディレクトリなどの項目の階層リストを表示するウィンドウです。各項目は、ラベルとオプションのビットマップイメージで構成され、関連付けられているサブ項目の一覧を含むことができます。項目をクリックすると、ユーザーは関連するサブ項目の一覧を展開または折りたたむことができます。

次の図は、ルートノード、展開されたノード、および折りたたまれたノードを含む単純なツリービューコントロールを示しています。コントロールは、選択した項目に 1 つのビットマップを使用し、他の項目には別のビットマップを使用します。

screen shot showing five nodes in a hierarchy; the text of one node is selected, but nodes are not linked to each other by lines

ツリービューコントロールを作成した後、コントロールにメッセージを送信することで、項目を追加、削除、配置、またはその他の操作を行います。各メッセージには、メッセージを明示的に送信する代わりに使用できる 1 つ以上の対応するマクロがあります。

このセクションでは、次のトピックについて説明します。

ツリービュースタイル
親項目と子項目
項目ラベル
ツリービューラベルの編集
ツリービュー項目の位置
ツリービュー項目の状態の概要
項目の選択
アイテム情報
ツリービューのイメージリスト
ドラッグアンドドロップ操作
ツリービューコントロールの通知メッセージ
既定のTree-View制御メッセージ処理
関連トピック

スタイルのTree-View

ツリービュースタイルは、ツリービューコントロールの外観の側面を制御します。初期スタイルは、ツリービューコントロールを作成するときに設定します。 GetWindowLong 関数と SetWindowLong 関数を使用してツリービューコントロールを作成した後、スタイルを取得および変更できます。

TVS_HASLINES スタイルは、次の図に示すように、子項目を親項目にリンクする線を描画することで、ツリービューコントロールの階層のグラフィック表現を強化します。

screen shot showing the previous arrangement, but with lines joining the nodes; the first line descends from the root node

それ自体では、このスタイルは階層のルートに線を描画しません。そのためには、 TVS_HASLINES スタイルと TVS_LINESATROOT スタイルを組み合わせる必要があります。結果を次の図に示します。

screen shot showing the previous arrangement, but with an additional horizontal line leading to the root node

ユーザーは、親項目をダブルクリックすることで、その子項目のリストを展開または折りたたみできます。 TVS_HASBUTTONS スタイルを持つツリービューコントロールは、各親項目の左側にボタンを追加します。ユーザーは、親項目をダブルクリックして子を展開または折りたたむ代わりに、ボタンを 1 回クリックできます。 TVS_HASBUTTONS は、階層のルートにある項目にボタンを追加しません。そのためには、TVS_HASLINES、TVS_LINESATROOT、TVS_HASBUTTONSを組み合わせる必要があります。このスタイルの組み合わせを次の図に示します。

screen shot showing the previous arrangement, but with expand/collapse buttons at each vertex of two lines

TVS_CHECKBOXES スタイルでは、各項目の横にチェックボックスが作成されます。チェックボックススタイルを使用する場合は、ツリービューコントロールを作成した後、およびツリーに設定する前に、 TVS_CHECKBOXES スタイル ( SetWindowLong を使用) を設定する必要があります。それ以外の場合は、タイミングの問題に応じて、チェックボックスがオフになっている可能性があります。次の図は、チェックボックスのスタイルを示しています。

screen shot showing the previous arrangement, but with a checkbox next to each node; two of the checkboxes are selected

TVS_FULLROWSELECT スタイルでは、項目自体だけでなく、コントロールの全幅に対して選択範囲の強調表示が拡張されます。次の図は、このスタイルを示しています。

screen shot showing the original arrangement of five nodes with no lines, but the selection highlight extends the full width of the control

TVS_EDITLABELS スタイルを使用すると、ユーザーはツリービュー項目のラベルを編集できます。ラベルの編集の詳細については、「ツリービューラベルの編集」を参照してください。

これらのスタイルとその他のスタイルの詳細については、「ツリービューコントロールウィンドウスタイル」を参照してください。

親項目と子項目

ツリービューコントロール内の任意の項目に、子項目と呼ばれるサブ項目の一覧を関連付けることができます。 1 つ以上の子項目を持つ項目を 親項目と呼びます。子項目は親項目の下に表示され、親の下位であることを示すためにインデントされます。階層の上部に親のない項目が表示され、 ルート項目と呼ばれます。

ツリービューコントロールに項目を追加するには、 TVM_INSERTITEM メッセージをコントロールに送信します。メッセージは、項目を一意に識別する HTREEITEM 型へのハンドルを返します。項目を追加するときは、新しい項目の親項目へのハンドルを指定する必要があります。 TVINSERTSTRUCT 構造体で親項目ハンドルの代わりに NULL またはTVI_ROOT値を指定した場合、項目はルート項目として追加されます。

いつでも、親項目の子項目のリストの状態を展開または折りたたみにすることができます。状態が展開の場合、子項目は親項目の下に表示されます。それが折りたたみの場合、子項目は表示されません。ユーザーが親アイテムをダブルクリックしたとき、または親アイテムに関連付けられているボタンをクリックしたときに、親アイテムが TVS_HASBUTTONS スタイルの場合、リストは展開された状態と折りたたまれた状態を自動的に切り替えます。アプリケーションは、 TVM_EXPAND メッセージを使用して子項目を展開または折りたたむことができます。

ツリービューコントロールは、親アイテムの子項目の一覧が展開または折りたたまれるときに、親ウィンドウに TVN_ITEMEXPANDING 通知メッセージを送信します。この通知により、アプリケーションは、変更を防止したり、子項目の一覧の状態に依存する親アイテムの属性を設定したりできます。リストの状態を変更した後、ツリービューコントロールは親ウィンドウに TVN_ITEMEXPANDED 通知メッセージを送信します。

子項目のリストが展開されると、親項目を基準にインデントされます。 TVM_SETINDENT メッセージを使用してインデントの量を設定したり、TVM_GETINDENT メッセージを使用して現在の量を取得したりできます。

ツリービューコントロールは、ツリービューコントロールを作成するプロセスのヒープから割り当てられたメモリを使用します。ツリービューの項目の最大数は、ヒープで使用可能なメモリの量に基づいています。

項目ラベル

通常、ツリービューコントロールに項目を追加するときに、項目のラベルのテキストを指定します。 TVM_INSERTITEM メッセージには、ラベルのテキストを含む文字列を含む、項目のプロパティを定義する TVITEM 構造体が含まれています。

ツリービューコントロールは、各項目を格納するためのメモリを割り当てます。項目ラベルのテキストは、このメモリのかなりの部分を占めます。アプリケーションがツリービューコントロール内の文字列のコピーを保持している場合は、実際の文字列をツリービューに渡す代わりに、TVITEM の pszText メンバーにLPSTR_TEXTCALLBACK値を指定することで、コントロールのメモリ要件を減らすことができます。 LPSTR_TEXTCALLBACKを使用すると、項目を再描画する必要がある場合は常に、ツリービューコントロールが親ウィンドウから項目のラベルのテキストを取得します。テキストを取得するために、ツリービューコントロールは、NMTVDISPINFO 構造体のアドレスを含むTVN_GETDISPINFO通知メッセージを送信します。親ウィンドウは、含まれている構造体の適切なメンバーを埋める必要があります。

Tree-Viewラベル編集

ユーザーは、 TVS_EDITLABELS スタイルを持つツリービューコントロール内の項目のラベルを直接編集できます。ユーザーは、フォーカスがある項目のラベルをクリックして編集を開始します。アプリケーションは、 TVM_EDITLABEL メッセージを使用して編集を開始します。ツリービューコントロールは、編集の開始時と、編集がキャンセルまたは完了したときに親ウィンドウに通知します。編集が完了すると、必要に応じて、親ウィンドウがアイテムのラベルを更新します。

ラベルの編集が開始されると、ツリービューコントロールは親ウィンドウにTVN_BEGINLABELEDIT 通知メッセージを送信します。この通知を処理することで、アプリケーションは一部のラベルの編集を許可し、他のラベルの編集を防ぐことができます。 0 を返す場合は編集でき、0 以外の値を返しても編集できません。

ラベルの編集が取り消されるか完了すると、ツリービューコントロールは親ウィンドウにTVN_ENDLABELEDIT 通知メッセージを送信します。 lParam パラメーターは、NMTVDISPINFO 構造体のアドレスです。 item パラメーターは、項目を識別し、編集されたテキストを含む TVITEM 構造体です。新しいラベルを保持する場合は、親ウィンドウでアイテムのラベルを更新します。編集が取り消された場合、TVITEM の pszText メンバーは 0 です。

ラベルの編集中、通常はTVN_BEGINLABELEDIT通知メッセージに応答して、 TVM_GETEDITCONTROL メッセージを 使用してラベル編集に使用される編集コントロールへのハンドルを取得できます。編集コントロールに EM_SETLIMITTEXT メッセージを送信して、ユーザーが編集コントロールを入力またはサブクラス化して無効な文字をインターセプトして破棄できるテキストの量を制限できます。ただし、編集コントロールは、TVN_BEGINLABELEDIT送信後にのみ表示されることに注意してください。

Tree-View項目の位置

項目の初期位置は、 TVM_INSERTITEM メッセージを使用して項目がツリービューコントロールに追加されるときに設定されます。メッセージには、親項目へのハンドルと、その後に新しい項目を挿入する項目へのハンドルを指定する TVINSERTSTRUCT 構造体が含まれています。 2 番目のハンドルは、指定された親の子項目、または TVI_FIRST、TVI_LAST、またはTVI_SORTのいずれかの値を識別する必要があります。

TVI_FIRSTまたはTVI_LASTを指定すると、ツリービューコントロールは、指定された親項目の子項目のリストの先頭または末尾に新しい項目を配置します。 TVI_SORTを指定すると、ツリービューコントロールは、項目ラベルのテキストに基づいて、子項目の一覧にアルファベット順で新しい項目を挿入します。

TVM_SORTCHILDREN メッセージを使用して、親アイテムの子項目の一覧をアルファベット順に配置できます。メッセージには、指定された親項目から派生するすべての子項目のレベルもアルファベット順に並べ替えられるかどうかを指定するパラメーターが含まれています。

TVM_SORTCHILDRENCB メッセージを使用すると、定義した条件に基づいて子アイテムを並べ替えることができます。このメッセージを使用する場合は、2 つの子項目の相対順序を決定する必要があるときに、ツリービューコントロールが呼び出すことができるアプリケーション定義のコールバック関数を指定します。コールバック関数は、比較対象の項目に対して 2 つの 32 ビットアプリケーション定義値と、 TVM_SORTCHILDRENCB送信時に指定する 3 番目の 32 ビット値を受け取ります。

Tree-View項目の状態の概要

ツリービューコントロールの各項目は、現在の状態です。各項目の状態情報には、一連のビットフラグと、アイテムの状態イメージとオーバーレイイメージを示すイメージリストインデックスが含まれます。ビットフラグは、項目が選択されているかどうか、無効になっているか、展開されているかなどを示します。ほとんどの場合、ツリービューコントロールは、項目の選択などのユーザーアクションを反映するように項目の状態を自動的に設定します。ただし、TVM_SETITEM メッセージを使用してアイテムの状態を設定したり、 TVM_GETITEMメッセージを 使用してアイテムの現在の状態を取得したりすることもできます。項目の状態の完全な一覧については、「ツリービューコントロール項目の状態」を参照してください。

項目の現在の状態は、TVITEM 構造体の状態メンバーによって指定されます。ツリービューコントロールでは、項目の選択や項目へのフォーカスの設定など、ユーザーアクションを反映するように項目の状態が変更される場合があります。さらに、アプリケーションは、項目の状態を変更して、項目を無効または非表示にしたり、オーバーレイイメージまたは状態イメージを指定したりすることがあります。

項目の状態を指定または変更すると、TVITEM の statemask メンバーは、設定する状態ビットを指定し、状態メンバーにはそれらのビットの新しい値が含まれます。

アイテムのオーバーレイイメージを設定するには、 statemask に TVIS_OVERLAYMASK 値を含める必要があります。また、 STATE には 、INDEXTOOVERLAYMASK マクロを使用して、8 ビット左にシフトされたオーバーレイイメージの 1 から始まるインデックスを含める必要があります。オーバーレイイメージを指定しない場合は、インデックスを 0 にできます。

状態イメージは、アプリケーション定義の状態を示す項目のアイコンの横に表示されます。状態イメージは、TVM_SETIMAGELIST メッセージを送信することによって指定された状態イメージリストに含まれます。項目の状態イメージを設定するには、TVITEM 構造体の statemask メンバーにTVIS_STATEIMAGEMASK値を含めます。構造体の状態メンバーのビット 12 から 15 は、描画するイメージの状態イメージリスト内のインデックスを指定します。

状態イメージインデックスを設定するには、 INDEXTOSTATEIMAGEMASK を使用します。このマクロはインデックスを受け取り、ビット 12 から 15 を適切に設定します。項目に状態イメージがないことを示すには、インデックスを 0 に設定します。この規則は、状態イメージリスト内のイメージ 0 を状態イメージとして使用できないことを意味します。状態メンバーのビット 12 から 15 を分離するには、TVIS_STATEIMAGEMASK マスクを使用します。オーバーレイイメージと状態イメージの詳細については、「ツリービューイメージリスト」を参照してください。

項目の選択

ツリービューコントロールは、TVN_SELCHANGINGと TVN_SELCHANGED 通知メッセージを送信することで、選択項目が別の項目に変更されたときに親ウィンドウに通知します。どちらの通知にも、変更がマウスクリックの結果かキーボード操作の結果かを指定する値が含まれます。選択項目の情報と、選択解除された項目の情報も含まれます。この情報を使用すると、項目の選択状態に依存する項目属性を設定できます。 TVN_SELCHANGINGに応答して TRUE を返した場合、選択内容が変更されるのを防ぎ、 FALSE を 返す場合は変更が許可されます。

アプリケーションは、 TVM_SELECTITEM メッセージを送信することによって選択を変更できます。

アイテム情報

ツリービューコントロールは、コントロール内の項目に関する情報を取得する多数のメッセージをサポートします。

TVM_GETITEM メッセージは、アイテムのハンドルと属性を取得できます。アイテムの属性には、現在の状態、項目の選択されたイメージと選択されていないビットマップイメージのコントロールのイメージリスト内のインデックス、項目に子項目があるかどうかを示すフラグ、アイテムのラベル文字列のアドレス、およびアイテムのアプリケーション定義の 32 ビット値が含まれます。

TVM_GETNEXTITEM メッセージは、現在のアイテムに対して指定されたリレーションシップを持つツリービュー項目を取得します。メッセージは、アイテムの親、次または前に表示される項目、最初の子項目などを取得できます。

TVM_GETITEMRECT メッセージは、ツリービュー項目の外接する四角形を取得します。 TVM_GETCOUNTメッセージとTVM_GETVISIBLECOUNT メッセージは、ツリービューコントロール内の項目の数と、ツリービューコントロールのウィンドウに完全に表示できる項目の数をそれぞれ取得します。 TVM_ENSUREVISIBLE メッセージを使用して、特定の項目を確実に表示できます。

Tree-View イメージリスト

ツリービューコントロールの各項目には、4 つのビットマップイメージを関連付けることができます。

アイテムを選択すると、開いているフォルダーなどの画像が表示されます。
アイテムが選択されていない場合に表示される閉じたフォルダーなどの画像。
選択したイメージまたは選択されていないイメージの上に透過的に描画されるオーバーレイイメージ。
状態イメージ。選択されたイメージまたは選択されていないイメージの左側に表示される追加の画像です。チェックボックスやクリアされたチェックボックスなどの状態イメージを使用して、アプリケーション定義の項目の状態を示すことができます。

既定では、ツリービューコントロールには項目イメージは表示されません。項目イメージを表示するには、イメージリストを作成し、コントロールに関連付ける必要があります。イメージリストの詳細については、「イメージリスト」を参照してください。

ツリービューコントロールには、通常のイメージリストと状態イメージリストという 2 つのイメージリストを含めることができます。通常のイメージリストには、選択された、選択されていない、オーバーレイの画像が格納されます。状態イメージリストには、状態イメージが格納されます。 ImageList_Create関数を使用してイメージリストを作成し、他のイメージリスト関数を使用してビットマップをイメージリストに追加します。次に、イメージリストをツリービューコントロールに関連付けるには、 TVM_SETIMAGELIST メッセージを使用します。 TVM_GETIMAGELIST メッセージは、ツリービューコントロールのイメージリストのいずれかに対するハンドルを取得します。このメッセージは、一覧に画像を追加する必要がある場合に便利です。

選択したイメージと選択されていないイメージに加えて、ツリービューコントロールの通常のイメージリストには、最大 4 つのオーバーレイ画像を含めることができます。オーバーレイ画像は、1 から始まるインデックスによって識別され、選択されたイメージと選択されていないイメージの上に透過的に描画されるように設計されています。オーバーレイマスクインデックスを通常のイメージリストのイメージに割り当てるには、 ImageList_SetOverlayImage 関数を呼び出します。

既定では、選択した状態と選択されていない状態の両方について、すべての項目に標準イメージリストの最初の画像が表示されます。また、既定では、アイテムにはオーバーレイ画像や状態イメージは表示されません。 TVM_INSERTITEMまたは TVM_SETITEM メッセージを送信することで、アイテムの既定の動作を変更できます。これらのメッセージでは 、TVITEM 構造体を使用して、項目のイメージリストインデックスを指定します。

項目の選択されたイメージと選択されていないイメージを指定するには、TVITEM 構造体のマスク メンバーにTVIF_SELECTEDIMAGEビットとTVIF_IMAGE ビットを設定し、iSelectImage メンバーと iImage メンバーのコントロールの通常のイメージリストのインデックスを指定します。または、インデックスを指定する代わりに、 iSelectImage と iImage でI_IMAGECALLBACK値を指定することもできます。これにより、項目が再描画されるたびに、コントロールはイメージリストインデックスの親ウィンドウに対してクエリを実行します。コントロールは、インデックスを取得するために TVN_GETDISPINFO 通知メッセージを送信します。

オーバーレイイメージを項目に関連付けるには、INDEXTOOVERLAYMASK マクロを使用して、アイテムの TVITEM 構造体の状態メンバーにオーバーレイマスクインデックスを指定します。 stateMask メンバーのTVIS_OVERLAYMASK ビットも設定する必要があります。オーバーレイマスクインデックスは 1 から始まります。インデックスが 0 の場合は、オーバーレイイメージが指定されていないことを示します。

状態イメージは、別の状態イメージリストに格納され、インデックスによって識別されます。状態イメージリストを指定するには、 TVM_SETIMAGELIST メッセージを送信します。 1 から始まるインデックスを使用して状態イメージを識別するリストビューコントロールとは異なり、ツリービューコントロールの状態イメージは 0 から始まるインデックスによって識別されます。ただし、インデックスが 0 の場合は、項目に状態イメージがないことを示します。そのため、イメージ 0 は状態イメージとして使用できません。項目の状態と状態イメージの詳細については、「ツリービュー項目の状態の概要」を参照してください。

ドラッグアンドドロップ操作

ツリービューコントロールは、ユーザーが項目のドラッグを開始したときに親ウィンドウに通知します。親ウィンドウは、ユーザーがマウスの左ボタンで項目のドラッグを開始すると TVN_BEGINDRAG 通知メッセージを受け取り、ユーザーが右ボタンでドラッグを開始すると TVN_BEGINRDRAG 通知メッセージを受け取ります。ツリービューコントロールに TVS_DISABLEDRAGDROP スタイルを指定することで、ツリービューコントロールがこれらの通知を送信できないようにすることができます。

TVM_CREATEDRAGIMAGE メッセージを使用して、ドラッグ操作中に表示する画像を取得します。ツリービューコントロールは、ドラッグする項目のラベルに基づいてドラッグビットマップを作成します。次に、ツリービューコントロールによってイメージリストが作成され、ビットマップが追加され、イメージリストにハンドルが返されます。

実際に項目をドラッグするコードを指定する必要があります。これは通常、イメージリスト関数のドラッグ機能を使用し、ドラッグ操作の開始後に親ウィンドウに送信される WM_MOUSEMOVE メッセージと WM_LBUTTONUP メッセージ (または WM_RBUTTONUP) を処理する必要があります。

ツリービューコントロール内の項目をドラッグアンドドロップ操作のターゲットにする場合は、マウスポインターがターゲット項目上にあるタイミングを把握する必要があります。 TVM_HITTEST メッセージを使用して確認できます。マウスポインターの現在の座標を含む TVHITTESTINFO 構造体のアドレスを指定します。 SendMessage 関数から制御が戻るときに、ツリービューコントロールに対するマウスポインターの位置を示すフラグが構造体に含まれます。ポインターがツリービューコントロール内の項目の上にある場合、構造体には項目へのハンドルも含まれます。

TVM_SETITEM メッセージを使用して状態をTVIS_DROPHILITED値に設定することで、項目がドラッグアンドドロップ操作のターゲットであることを示すことができます。この状態にある項目は、ドラッグアンドドロップターゲットを示すために使用されるスタイルで描画されます。

Tree-View コントロールの通知メッセージ

ツリービューコントロールは、次の通知メッセージを、 WM_NOTIFY メッセージの形式で親ウィンドウに送信します。

Notification	Description
TVN_BEGINDRAG	ドラッグアンドドロップ操作の開始を通知します。
TVN_BEGINLABELEDIT	インプレースラベル編集の開始を通知します。
TVN_BEGINRDRAG	マウスの右ボタンがドラッグアンドドロップ操作を開始したことを通知します。
TVN_DELETEITEM	特定の項目の削除を通知します。
TVN_ENDLABELEDIT	ラベル編集の終了を通知します。
TVN_GETDISPINFO	ツリービューコントロールが項目を表示するために必要な情報を要求します。
TVN_ITEMEXPANDED	親アイテムの子項目の一覧が展開または折りたたまれたことを示します。
TVN_ITEMEXPANDING	親アイテムの子項目の一覧が展開または折りたたまれることを示します。
TVN_KEYDOWN	キーボードイベントを通知します。
TVN_SELCHANGED	選択範囲が 1 つの項目から別の項目に変更されたことを通知します。
TVN_SELCHANGING	選択範囲が 1 つの項目から別の項目に変更されることを通知します。
TVN_SETDISPINFO	親ウィンドウに対して、アイテムに対して保持する情報を更新する必要があることを通知します。

既定のTree-View制御メッセージ処理

このセクションでは、ツリービューコントロールによって実行されるウィンドウメッセージ処理について説明します。ツリービューコントロールに固有のメッセージについては、このドキュメントの他のセクションで説明しているため、ここには含まれません。

Message	実行された処理
WM_COMMAND	EN_UPDATEおよび編集コントロール通知メッセージEN_KILLFOCUS処理し、その他のすべての編集コントロール通知を親ウィンドウに転送します。戻り値がありません。
WM_CREATE	メモリを割り当て、内部データ構造を初期化します。成功した場合は 0 を返し、それ以外の場合は -1 を返します。
WM_DESTROY	コントロールに関連付けられているすべてのシステムリソースを解放します。 0 を返します。
WM_ENABLE	コントロールを有効または無効にします。
WM_ERASEBKGND	ツリービューコントロールの現在の背景色を使用して、ウィンドウの背景を消去します。 TRUE を返します。
WM_GETDLGCODE	DLGC_WANTARROWS値とDLGC_WANTCHARS値の組み合わせを返します。
WM_GETFONT	現在のラベルフォントへのハンドルを返します。
WM_HSCROLL	ツリービューコントロールをスクロールします。スクロールが発生した場合は TRUE 、それ以外の場合は FALSE を返します。
WM_KEYDOWN	すべてのキーの親ウィンドウに TVN_KEYDOWN 通知メッセージを送信します。ユーザーが Enter キーを押したときに、NM_RETURN (ツリービュー) 通知メッセージを送信します。ユーザーが方向キーまたは PAGE UP、PAGE DOWN、HOME、END、BACKSPACE キーを押すと、キャレットが移動します。ユーザーが Ctrl キーをこれらのキーと組み合わせて押すと、ツリービューコントロールがスクロールされます。キーが処理されている場合は TRUE 、それ以外の場合は FALSE を返します。
WM_KILLFOCUS	フォーカスされた項目 (存在する場合) を再描画し、 NM_KILLFOCUS (ツリービュー) 通知メッセージを親ウィンドウに送信します。
WM_LBUTTONDBLCLK	ラベルの編集をキャンセルし、項目がダブルクリックされた場合は、 NM_DBLCLK (ツリービュー) 通知メッセージを親ウィンドウに送信します。親ウィンドウが 0 を返す場合、ツリービューコントロールは項目の展開状態を切り替え、親ウィンドウに TVN_ITEMEXPANDING と TVN_ITEMEXPANDED 通知メッセージを送信します。戻り値がありません。
WM_LBUTTONDOWN	ユーザーが親項目に関連付けられているボタンをクリックした場合に、展開された状態を切り替えます。ユーザーが項目ラベルをクリックした場合、ツリービューコントロールによって項目にフォーカスが選択され、設定されます。ユーザーがマウスボタンを離す前にマウスを移動すると、ツリービューコントロールによってドラッグアンドドロップ操作が開始されます。戻り値がありません。
WM_PAINT	ツリービューコントロールの無効な領域を描画します。 0 を返します。 wParam パラメーターが NULL 以外の場合、コントロールは値がデバイスコンテキスト (HDC) へのハンドルであると見なし、そのデバイスコンテキストを使用して描画します。
WM_RBUTTONDOWN	項目がクリックされ、ドラッグ操作が開始されたかどうかを確認します。操作が開始された場合、親ウィンドウにTVN_BEGINRDRAG 通知メッセージが送信され、ドロップ先が強調表示されます。それ以外の場合は、 NM_RCLICK (ツリービュー) 通知メッセージが親ウィンドウに送信されます。戻り値がありません。
WM_SETFOCUS	フォーカスされた項目がある場合は再描画し、 NM_SETFOCUS 通知メッセージを親ウィンドウに送信します。
WM_SETFONT	指定したフォントハンドルを保存し、新しいフォントを使用してツリービューコントロールを再描画します。
WM_SETREDRAW	再描画フラグを設定またはクリアします。ツリービューコントロールは、再描画フラグが設定された後に再描画されます。 0 を返します。
WM_SIZE	ツリービューコントロールのクライアント領域のサイズに依存する内部変数を再計算します。 TRUE を返します。
WM_STYLECHANGED	ラベルの編集をキャンセルし、新しいスタイルを使用してツリービューコントロールを再描画します。 0 を返します。
WM_SYSCOLORCHANGE	再描画フラグが設定されている場合は、新しい色を使用してツリービューコントロールを再描画します。戻り値がありません。
WM_TIMER	項目ラベルの編集を開始します。ユーザーがフォーカスされた項目のラベルをクリックすると、ツリービューコントロールは編集モードにすぐに入るのではなく、タイマーを設定します。タイマーを使用すると、ユーザーがラベルをダブルクリックすると、ツリービューが編集モードに入らないようにすることができます。 0 を返します。
WM_VSCROLL	ツリービューコントロールをスクロールします。スクロールが発生した場合は TRUE 、それ以外の場合は FALSE を返します。

サンプル: CustDTv は、TreeView でのカスタム描画を示しています (Q248496)