使用CListCtrl与CImageList仅显示首个图标，求解决方法

我使用CListCtrl和CImageList类实现列表缩略图功能，测试用的位图如下：

编写的代码如下：

m_imageList.Create(IDB_BITMAP1, 16, 1, RGB(255, 0, 255));

int nSize = m_imageList.GetImageCount();
for (int i = 0; i < nSize; i++)
{
    CString str = L"";
    str.Format(L"%d", i);
    m_listCtrl.InsertItem(LVIF_TEXT, i, str, 0, 0, 0, NULL);
    LVITEM lvi = { 0 };
    lvi.mask = LVCF_IMAGE;
    lvi.iItem = i;
    lvi.iImage = i;
    BOOL bRes = m_listCtrl.SetItem(&lvi);
}
m_listCtrl.SetImageList(&m_imageList, TVSIL_NORMAL);

但运行后列表仅显示第一个图标，效果如下：

尝试过站内相关解决方案，问题依然存在，项目基于MSVS2022。

问题排查与修复 #

1. 核心错误：图像列表标识用错

代码里用了TVSIL_NORMAL，这是树控件（CTreeCtrl） 的图像列表标识，CListCtrl应该使用LVSIL_NORMAL，这个错误会导致控件无法正确关联图像列表。

2. 关联时机错误

必须先将图像列表绑定到CListCtrl，再插入列表项。原代码是插入完所有项才绑定，控件在插入时无法识别图标索引。

3. 图像列表创建参数限制

Create函数的第三个参数nGrow设置为1，会限制图像列表只能扩展1个图像。如果你的位图包含多个图标，应将此值设为足够大（比如图标数量）或0，让系统自动处理增长。

4. 冗余的SetItem调用

InsertItem可以同时指定LVIF_TEXT | LVIF_IMAGE标志，直接在插入时设置图标，不需要额外调用SetItem。

修正后的代码 #

// 创建图像列表，调整nGrow参数为4（按需设置）
m_imageList.Create(IDB_BITMAP1, 16, 4, RGB(255, 0, 255));
// 先关联图像列表到CListCtrl，使用正确的标识LVSIL_NORMAL
m_listCtrl.SetImageList(&m_imageList, LVSIL_NORMAL);

int nSize = m_imageList.GetImageCount();
for (int i = 0; i < nSize; i++)
{
    CString str;
    str.Format(L"%d", i);
    // 插入时同时指定文本和图标索引
    m_listCtrl.InsertItem(LVIF_TEXT | LVIF_IMAGE, i, str, i, 0, 0, NULL);
}

额外检查点 #

• 确认IDB_BITMAP1是包含多个16x16图标的连续位图，位图宽度应为16 * 图标数量，高度16，这样CImageList才能正确分割出所有图标。
• 确保位图的透明色与代码中设置的RGB(255, 0, 255)一致。

内容的提问来源于stack exchange，提问作者victor kulichkin