列表项和图像列表

列表控件(CListCtrl)中的“item”由图标、标签和其他信息(在“子项”中)组成。

列表控件项的图标包含在图像列表中。 一个图像列表包含图标视图中使用的全尺寸图标。 第二个可选图像列表包含用于控件的其他视图的相同图标的较小版本。 第三个可选列表包含“状态”图像,例如复选框,用于在某些视图中的小图标前面显示。 第四个可选列表包含显示在列表控件的各个标头项中的图像。

注释

如果使用LVS_SHAREIMAGELISTS样式创建列表视图控件,则你负责在不再使用图像列表时销毁图像列表。 如果将相同的图像列表分配给多个列表视图控件,请指定此样式;否则,多个控件可能会尝试销毁相同的图像列表。

有关列表项的详细信息,请参阅 Windows SDK 中的列表视图图像列表和项和子项。 另请参阅 MFC 参考中的类 CImageList 和在本系列文章中使用 CImageList

若要创建列表控件,需要在列表中插入新项时提供要使用的图像列表。 以下示例演示此过程,其中 m_pImagelist 是类型的 CImageList 指针, m_listctrlCListCtrl 数据成员。

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
控件