Windows任务栏图标叠加需启用ITaskbarList3接口，前提是窗口已合法注册为任务栏按钮；必须初始化COM、检查系统版本、调用HrInit()，并使用GDI+生成16×16 ARGB图标，避免缩放失真；若失败，需排查HWND有效性、DPI适配及系统通知设置是否关闭。
Windows任务栏图标叠加（Taskbar Overlay）需要启用并配置ITaskbarList3
Windows 7+ 支持在任务栏图标右上角显示数字或自定义图标叠加（Overlay），但默认不启用，且 C++ 程序必须显式调用 ITaskbarList3 接口。关键前提是：你的窗口必须已注册为任务栏按钮（即拥有合法的 HWND，且未被设为工具窗口或无任务栏项）。
常见失败原因不是代码写错，而是没调用 SetWindowExtension 或未触发任务栏注册时机——比如在 WM_CREATE 之前就尝试设置叠加，此时窗口尚未关联到任务栏。
- 必须链接
shell32.lib并初始化 COM（CoInitialize(nullptr)） - 获取接口前需检查 Windows 版本（
IsWindows7OrGreater()），低于 Win7 返回失败 -
ITaskbarList3::SetOverlayIcon()第二个参数是描述字符串，传nullptr可清空叠加；若只显示数字，需先生成带数字的图标（GDI+ 或内存位图）
如何生成带数字的 overlay 图标（16×16 像素）
Windows 任务栏 overlay 图标尺寸固定为 16×16 像素，且要求 Alpha 通道清晰。不能直接用文字渲染到任意大小图标再缩放——模糊或锯齿会导致叠加被忽略或显示为白块。
推荐做法：用 GDI+ 在内存中创建 16×16 Bitmap，用 Graphics::DrawString 渲染居中数字（字体选 Segoe UI，大小 ~8pt），背景全透明，数字纯白带 1px 黑描边（提升可读性）。最后用 Bitmap::GetHICON() 转成 HICON。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 避免使用
CreateFont+TextOut：GDI 文字抗锯齿不可控，易导致图标被系统拒绝 - 数字超过 99 时建议显示 “99+”，Windows 对三位以上数字叠加支持不稳定
- 图标必须为 32bpp ARGB 格式；用
Bitmap::LockBits手动填充像素时，确保 Alpha=0 的区域完全透明
调用 SetOverlayIcon 失败的典型错误
即使图标生成正确，ITaskbarList3::SetOverlayIcon 返回 S_OK 也不代表一定显示——它只表示系统接收了请求。实际是否渲染取决于当前任务栏状态和窗口焦点。
- 用户切换到其他应用时，overlay 仍会保留；但若你的进程被挂起（如调试断点停住），系统可能延迟刷新或丢弃请求
- 返回
E_FAIL：常见于未调用ITaskbarList3::HrInit()，或窗口HWND已销毁但接口未释放 - 返回
0x80070057（E_INVALIDARG）：图标尺寸非 16×16，或HICON来自LoadIcon（而非 GDI+ 动态生成） - 任务栏设置中关闭了“显示任务栏按钮上的通知”（Win10/11 设置 → 个性化 → 任务栏 → “通知”开关），此时任何 overlay 都不会显示
替代方案：使用 Jump List + 自定义类别显示未读数
如果 overlay 不稳定（尤其多显示器、DPI 缩放场景下），更健壮的做法是把未读数放进 Jump List 的静态或动态类别中。虽然不直接在图标上，但右键菜单实时可见，且兼容 Win7–Win11。
用 ICustomDestinationList 添加带计数的跳转项，例如 “收件箱 (3)” —— 用户右键图标即可看到，无需额外图标资源。
- Jump List 更新无需 COM 初始化，只需
SHCreateItemFromParsingName和IShellLink - 注意：每次更新需调用
AppendCategory后再CommitList，否则变更不生效 - 相比 overlay，Jump List 更容易测试和调试，且不受 DPI 缩放影响
真正难的不是画那个小数字，而是让系统相信你这个窗口值得被标记——它得有合法身份、及时响应、并且没被用户手动屏蔽过。很多项目卡在第一步：窗口还没被任务栏“认领”，你就急着贴数字。
