リスト項目とイメージ リスト

  • [アーティクル]

リスト コントロール (CListCtrl) の "項目" は、アイコン、ラベル、そして場合によっては ("サブ項目" 内の) その他の情報で構成されます。

リスト コントロール項目のアイコンは、イメージ リストに含まれています。 1 つのイメージ リストに、アイコン ビューで使用されるフルサイズのアイコンが含まれています。 2 つ目のオプションのイメージ リストには、コントロールの他のビューで使用する小さいバージョンの同じアイコンが含まれています。 3 つ目のオプションのリストには、特定のビューの小さいアイコンの前に表示する、チェック ボックスなどの "状態" のイメージが含まれています。 4 つ目のオプションのリストには、リスト コントロールの個々のヘッダー項目に表示されるイメージが含まれています。

Note

リスト ビュー コントロールが 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);

ただし、リスト ビューやリスト コントロールにアイコンを表示する予定がない場合、イメージ リストは必要ありません。

関連項目

CListCtrl の使い方
コントロール