TreeView_SetCheckState マクロ (commctrl.h)

アイテムの状態イメージを "checked" または "unchecked" に設定します。 TVM_SETITEM メッセージを直接使用することもできます。

構文

void TreeView_SetCheckState(
   hwndTV,
   hti,
   fCheck
);

パラメーター

hwndTV

種類: HWND

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

hti

型: HTREEITEM

項目へのハンドル。

fCheck

種類: BOOL

表示される状態イメージを示す値。 チェック状態の画像を表示するには fCheck を TRUE に設定し、チェックされていない画像を表示するには FALSE に 設定します。

戻り値

なし

解説

ツリー ビュー コントロールには、2 つのイメージ リストを含めることができます。 通常のイメージ リストには、選択したイメージ、選択されていないイメージ、オーバーレイ イメージが格納されます。 チェック ボックスは状態イメージ リストに格納され、対応する標準イメージの左側に表示されます。 状態イメージは、1 から始まるインデックスで指定されます。 0 のインデックスは、状態イメージがないことを示します。 ツリー ビュー イメージの処理方法については、「ツリー ビュー イメージのLists」を参照してください。

独自の状態イメージを定義する場合、このマクロでは、チェックされたイメージとチェックされていないイメージのインデックスが標準イメージ リストと同じであることを前提としています。オフの場合は 1、checked の場合は 2 です。

要件

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