ListView中.LNK文件图标未添加系统图像列表快捷方式覆盖层问题

核心原因 #

你遇到的问题本质是：系统图像列表（通过SHGFI_SYSICONINDEX获取）中的图标索引仅对应原始类型图标，不包含快捷方式的覆盖层。SHGFI_ADDOVERLAYS和SHGFI_LINKOVERLAY标志只是让SHGetFileInfo返回带覆盖层的图标句柄，但不会修改系统图像列表中的索引项——你存储的iconIndex依然是原始图标的索引，自然不会显示覆盖层。

解决方案：使用ListView的覆盖层功能 #

无需替换系统图像列表，只需补充获取覆盖层索引并在ListView项中配置即可，步骤如下：

1. 修改SHGetFileInfo调用，获取覆盖层索引

在原有标志基础上添加SHGFI_OVERLAYINDEX，让函数返回覆盖层的索引信息：

ZeroMemory(&shFileInfo, sizeof(shFileInfo));        
std::wstring fullpath = dir + L"\\" + objname;

// 添加SHGFI_OVERLAYINDEX标志，用于获取覆盖层索引
SHGetFileInfo(fullpath.c_str(),
              0, 
              &shFileInfo, sizeof(shFileInfo), 
              SHGFI_TYPENAME | SHGFI_ICON | SHGFI_SMALLICON | 
              SHGFI_SYSICONINDEX | SHGFI_ADDOVERLAYS | SHGFI_LINKOVERLAY | SHGFI_OVERLAYINDEX);

// 解析图标索引和覆盖层索引：iIcon高8位是覆盖层索引（从1开始），低8位是原始图标索引
int iconIndex = shFileInfo.iIcon & 0xFF;
int overlayIndex = (shFileInfo.iIcon >> 8) & 0xFF;

// 将两个索引都存入你的数据结构
MyStruct s;
s.iconIndex = iconIndex;
s.overlayIndex = overlayIndex;
s.name = objname;
structVector.push_back(s);

2. 修改ListView项添加逻辑，启用覆盖层

更新LVITEM的mask包含LVIF_OVERLAY，并设置覆盖层索引（注意转换为0-based索引，因为系统返回的覆盖层索引从1开始）：

// Add ListView Items
LVITEM lvi;
for (int i = 0; i < structVector.size(); i++) {
    ZeroMemory(&lvi, sizeof(lvi));
    lvi.mask = LVIF_TEXT | LVIF_IMAGE | LVIF_OVERLAY; // 新增LVIF_OVERLAY
    lvi.pszText = const_cast<wchar_t*>(structVector.at(i).name.c_str());
    lvi.iItem = i;
    lvi.iImage = structVector.at(i).iconIndex;        
    // 配置覆盖层：系统返回的overlayIndex从1开始，ListView需要0-based索引
    lvi.iOverlay = structVector.at(i).overlayIndex > 0 ? (structVector.at(i).overlayIndex - 1) : 0;
    ListView_InsertItem(hWndListView, &lvi);
}

替代方案：自建图像列表存储合成图标 #

如果更倾向于直接使用带覆盖层的完整图标，可以创建自定义图像列表，将每个文件的合成图标（shFileInfo.hIcon）添加进去，再关联到ListView：

// 创建自定义图像列表（大小匹配系统小图标）
HIMAGELIST hCustomImageList = ImageList_Create(16, 16, ILC_COLOR32 | ILC_MASK, 0, 10);

// 遍历文件时添加图标到自定义列表
for (auto& s : structVector) {
    std::wstring fullpath = dir + L"\\" + s.name;
    SHFILEINFO shFileInfo;
    ZeroMemory(&shFileInfo, sizeof(shFileInfo));
    SHGetFileInfo(fullpath.c_str(), 0, &shFileInfo, sizeof(shFileInfo), 
                  SHGFI_ICON | SHGFI_SMALLICON | SHGFI_ADDOVERLAYS | SHGFI_LINKOVERLAY);
    // 添加图标到自定义列表，保存索引
    int imgIdx = ImageList_AddIcon(hCustomImageList, shFileInfo.hIcon);
    s.customIconIndex = imgIdx;
    // 释放临时图标句柄，避免内存泄漏
    DestroyIcon(shFileInfo.hIcon);
}

// 关联自定义图像列表到ListView
SendMessage(hWndListView, LVM_SETIMAGELIST, (WPARAM)LVSIL_SMALL, (LPARAM)hCustomImageList);

// 添加ListView项时使用自定义列表的索引
LVITEM lvi;
for (int i = 0; i < structVector.size(); i++) {
    ZeroMemory(&lvi, sizeof(lvi));
    lvi.mask = LVIF_TEXT | LVIF_IMAGE;
    lvi.pszText = const_cast<wchar_t*>(structVector.at(i).name.c_str());
    lvi.iItem = i;
    lvi.iImage = structVector.at(i).customIconIndex;        
    ListView_InsertItem(hWndListView, &lvi);
}

注意事项 #

• 方案一更高效，复用系统图像列表，无需手动管理图标内存；
• 方案二适合需要完全自定义图标的场景，但要注意及时调用DestroyIcon释放临时句柄，避免内存泄漏。

内容的提问来源于stack exchange，提问作者gene b.