拡張スタイルを Tree-View コントロールする

  • [アーティクル]

このセクションでは、ツリー ビュー コントロールを作成するときに使用される拡張スタイルの一覧を示します。 拡張スタイルの値は、これらのスタイルのビットごとの組み合わせです。

常時 説明
TVS_EX_AUTOHSCROLL
 Windows Vista。 マウスの位置に応じて、水平スクロール バーと自動スクロールを削除します。
TVS_EX_DIMMEDCHECKBOXES
 Windows Vista。 特定の項目の左端に、淡色表示されたチェック マークのアイコンを含むチェック ボックスを追加します。このチェック ボックスは、ノードが親が選択されているために選択されていることを示します。 これには、2 つの通常のチェック ボックスの状態に加えて、淡色表示されたチェック ボックスの状態が含まれます。 TVS_CHECKBOXES スタイルと同時に使用しないでください。 下記の「注意」を参照。
TVS_EX_DOUBLEBUFFER
 Windows Vista。 背景を消去または塗りつぶす方法を指定します。
TVS_EX_DRAWIMAGEASYNC
 Windows Vista。 予定表グリッド情報を取得します。
TVS_EX_EXCLUSIONCHECKBOXES
 Windows Vista。 赤い X を含む特定の項目の左端にチェック ボックス アイコンを追加します。これには、2 つの通常のチェックボックス状態に加えて、除外チェックボックスの状態が含まれます。 TVS_CHECKBOXES スタイルと同時に使用しないでください。 下記の「注意」を参照。
TVS_EX_FADEINOUTEXPANDOS
 Windows Vista。 マウスが離れたとき、またはコントロールの上にマウスポインターを合わせた状態になったときに、展開ボタンをフェードインまたはフェードアウトします。
TVS_EX_MULTISELECT
 サポートされていません。 使用しないでください。
TVS_EX_NOINDENTSTATE
 Windows Vista。 expando ボタンのツリー ビューをインデントしないでください。
TVS_EX_NOSINGLECOLLAPSE
 Windows Vista。 内部使用を目的としています。アプリケーションでの使用は推奨されません。 以前に選択したツリー ビュー項目が新しい選択項目と同じ親を持つ場合を除き、折りたたみないでください。 このスタイルは、 TVS_SINGLEEXPAND スタイルで使用する必要があります。
メモ： このスタイルは、今後のバージョンの Comctl32.dll ではサポートされない可能性があります。 また、このスタイルは commctrl.h では定義されていません。 このスタイルを使用するには、アプリケーションのソース ファイルに次の定義を追加します。 #define TVS_EX_NOSINGLECOLLAPSE 0x0001
TVS_EX_PARTIALCHECKBOXES
 Windows Vista。 ノードが部分的に選択されていることを示す、中央に四角形がある特定の項目の左端にチェック ボックス アイコンを追加します。 これには、2 つの通常のチェックボックス状態に加えて、部分的なチェックボックス状態が含まれます。 TVS_CHECKBOXES スタイルと同時に使用しないでください。 下記の「注意」を参照。
TVS_EX_RICHTOOLTIP
 Windows Vista。 ツリー ビューで豊富なツールヒントを許可する (アイコンとテキストで描画されたカスタム)。

拡張チェックボックススタイルの使用に関する注意

ツリー ビュー コントロールには、チェック ボックス のスタイルに対して非常に固有の動作があります。 特定のスタイルまたは 'EX' スタイルの組み合わせがアクティブ化されると、コントロールはそれを有効期間の最後まで保持します (つまり、ツリー ビュー コントロールの有効期間中に最初のチェック ボックス スタイルを変更することはできません)。

拡張されたチェック ボックス スタイルを使用してツリー ビュー コントロールを作成するには、最初にコントロール ウィンドウをTVS_CHECKBOXESスタイルなしで作成し、 選択 した拡張チェック ボックス スタイルを追加 (作成後) するには、 TVM_SETEXTENDEDSTYLE メッセージを送信するか 、TreeView_SetExtendedStyle マクロを使用する必要があります。 拡張チェックボックス スタイルには、TVS_EX_DIMMEDCHECKBOXES、TVS_EX_EXCLUSIONCHECKBOXES、またはTVS_EX_PARTIALCHECKBOXESスタイルの任意の OR 組み合わせを指定できます。

新しいツリー ビュー コントロールでは、2 つの標準のチェック ボックスの状態 (オンとオフ) に加えて、1 から 3 つの追加状態 (選択した拡張スタイルの関数) が提供されます。 通常の状態は常に0x1000および0x2000としてコード化され、追加の状態は次の値 (0x3000、0x4000、0x5000) でコーディングされます。 定数 ( 0xF000) TVIS_STATEIMAGEMASKをマスクとして使用して、これらの状態を TVITEM 構造体に対して取得または設定します。

必要条件

要件 値
ヘッダー
CommCtrl.h