リスト コントロール (CListCtrl) の "item" は、アイコン、ラベル、および場合によっては他の情報 ("サブ項目" 内) で構成されます。
リスト コントロール項目のアイコンは、イメージ リストに含まれています。 1 つの画像リストには、アイコン ビューで使用されるフルサイズのアイコンが含まれています。 2 つ目のオプションのイメージ リストには、コントロールの他のビューで使用するために同じアイコンの小さいバージョンが含まれています。 3 番目のオプション リストには、特定のビューの小さなアイコンの前に表示するための "状態" 画像 (チェック ボックスなど) が含まれています。 4 番目の省略可能なリストには、リスト コントロールの個々のヘッダー項目に表示される画像が含まれています。
注
リスト ビュー コントロールが LVS_SHAREIMAGELISTS スタイルで作成された場合は、使用されなくなったイメージ リストを破棄する必要があります。 同じイメージ リストを複数のリスト ビュー コントロールに割り当てる場合は、このスタイルを指定します。それ以外の場合、複数のコントロールが同じイメージ リストを破棄しようとする可能性があります。
リスト アイテムの詳細については、「Windows SDK の リスト ビューイメージリスト と アイテムとサブアイテム 」を参照してください。 この記事ファミリの MFC リファレンスおよび CImageList の使用に関する記事の CImageList クラスも参照してください。
リスト コントロールを作成するには、リストに新しい項目を挿入するときに使用するイメージ リストを指定する必要があります。 次の例では、このプロシージャを示 します。ここで、m_pImagelist は CImageList 型のポインターであり、 m_listctrl は CListCtrl データ メンバーです。
m_ListImageList.Create(16, 16, ILC_COLOR, 2, 2);
m_ListImageList.Add(AfxGetApp()->LoadIcon(IDI_ICON1));
m_ListImageList.Add(AfxGetApp()->LoadIcon(IDI_ICON2));
m_ListCtrl.SetImageList(&m_ListImageList, LVSIL_SMALL);
ただし、リスト ビューまたはリスト コントロールにアイコンを表示する予定がない場合は、画像リストは必要ありません。