ツリー コントロールのイメージ リスト
ツリー コントロール （CTreeCtrl）の各項目に関連付けられたビットマップ付きイメージのペアを持つことができます。イメージは、項目のラベルの左側に表示されます。1 種類のイメージは、項目が選択されていない場合は、項目が選択され、もう一方が表示されるときに表示されます。たとえば、項目が選択されていない場合は閉じますフォルダーを選択したときに開いているフォルダーを表示することもできます。
項目イメージを使用するには、 CImageList オブジェクトを構築し、関連付けられたイメージ リストを作成するに CImageList::Create 関数を使用してイメージ リストを作成します。その後、目的のビットマップを一覧に追加して、ツリー コントロールで SetImageList のメンバー関数を使用してリストを関連付けます。既定では、すべての項目が選択され、 nonselected 状態のイメージ リストの最初のイメージを表示します。選択され、 nonselected イメージのインデックスを指定して特定のアイテムの既定の動作を変更する項目を InsertItem のメンバー関数を使用してツリー コントロールに追加する場合。項目を追加した後 SetItemImage のメンバー関数ではインデックスを変更できます。
ツリー コントロールのイメージ リストは、項目イメージに重ね合わせて示すように設計されたオーバーレイ イメージを含めることができます。8 ビットからツリー コントロール項目の状態の 11 以外の値は、オーバーレイ イメージの 1 から始まるインデックスを指定します （0 がオーバーレイ イメージは表示されません）。4 ビットは、 1 から始まるインデックスが使用されているため、オーバーレイ イメージは、イメージ リストの最初の 15 のイメージ間にある必要があります。ツリー コントロール項目の状態に関する詳細については、このトピックの ツリー コントロール項目は、概要を示します を " を参照してください。
状態イメージのリストを指定した場合、状態イメージの各項目のアイコンの左側のツリー コントロールの予約済みの領域。アプリケーションは、アプリケーション定義された項目のステータスを表示する状態イメージを、チェックされ、オフ チェック ボックスなどを使用できます。12 ビットから 15 のゼロ以外の値は状態イメージの 1 から始まるインデックスを指定します （0 が状態イメージが表示されません）。
イメージのインデックスの代わりに I_IMAGECALLBACK 値を指定して、項目の再描画の実行を開始するまで選択または nonselected イメージを指定することもできます。I_IMAGECALLBACK は TVN_GETDISPINFO の通知メッセージを送信することによってインデックスのアプリケーションを照会するにツリー コントロールに指示します。
GetImageList のメンバー関数は、ツリー コントロールのイメージ リストのハンドルを取得します。この関数は、リストにイメージを追加する必要がある場合に便利です。イメージ リストに関する詳細については、 Windows SDKの MFCリファレンス CImageList を使用する、 CImageList 、および イメージ リスト を参照してください。