讲师中心 微信公众号
AI工具推荐 视频效率加速

C++ Qt如何调用Windows本地API获取系统原生图标

千浩吖_2236

千浩吖_2236

发布时间:2026-10-27 08:23:32

|

617人浏览过

|

来源于php中文网

原创

SHGetFileInfo是获取Windows系统图标句柄最直接方法,需传SHGFI_ICON标志、支持路径/扩展名/CLSID输入,返回HICON须用DestroyIcon释放,并转为QPixmap显示。

c++ qt如何调用windows本地api获取系统原生图标

用 SHGetFileInfo 获取系统图标句柄最直接

Qt 本身不封装 Windows 原生图标(如文件类型、驱动器、控制面板项的图标),必须调用 Shell API。核心函数是 SHGetFileInfo,它能根据路径、CLSID 或文件扩展名返回图标句柄(HICON)和系统图标索引。

关键点:必须传入 SHGFI_ICON 标志,且需提前调用 CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED)(Qt GUI 线程通常已初始化,但显式调用更稳妥);图标使用完后务必用 DestroyIcon 释放,否则内存泄漏。

  • pszPath 可为真实路径(如 "C:\Windows\explorer.exe")、扩展名(如 ".txt")或 CLSID 字符串(如 "{20D04FE0-3AEA-1069-A2D8-08002B30309D}" 表示“此电脑”)
  • 若只想要图标不关心文件属性,dwFileAttributes 可设为 0,但传 FILE_ATTRIBUTE_NORMAL 更安全
  • 返回的 HICON 是 GDI 句柄,不能直接塞进 QIcon,需先转成 QPixmap

把 HICON 转成 QPixmap 需手动位图提取

Qt 没有内置 HICON → QPixmap 的转换函数,必须用 GetIconInfo + GetDIBits 提取像素数据。常见错误是忽略图标可能含 alpha 通道(32bpp)或使用色表(8bpp),导致透明背景变黑或颜色失真。

实操建议:

立即学习“C++免费学习笔记(深入)”;

直播间话术巡检-windows
直播间话术巡检-windows

直播话术巡检系统(Windows版) — 实时语音转写、关键词检测、场景自动切换、告警推送、大屏可视化。支持 Windows VB-Cable 虚拟声卡音频采集,阿里云 ASR 实时识别。一键启动脚本,自动安装环境。

下载
  • 调用 GetIconInfo 获取 ICONINFO,检查 hbmColor 是否有效(部分小图标可能只有 hbmMask)
  • 优先用 GetDIBits 读取 hbmColor,格式指定为 BI_RGB,位深设为 32;若失败再降级处理 16/8bpp 图标
  • 注意 Windows 图标坐标系 Y 轴朝下,而 Qt QImage 朝上,需垂直翻转像素行
  • 构造 QImage 时用 QImage::Format_ARGB32_Premultiplied 保证 alpha 正确合成

在 Qt 中复用图标要缓存 HICON 而非 QPixmap

频繁调用 SHGetFileInfo 开销大,且反复创建/销毁 HICON 容易触发 GDI 句柄泄漏(Windows 限制每进程约 10000 个 GDI 对象)。正确做法是缓存 HICON 句柄本身(用 QHash<qstring hicon></qstring>),并在应用退出或主题切换时统一销毁。

特别注意:

  • 不要缓存 QPixmap 并假设它适配所有 DPI —— 高 DPI 下原图标可能模糊,应按需缩放;更稳妥的是缓存原始 HICON,每次需要时用 DrawIconEx 渲染到目标 QPixmap 尺寸
  • 监听 QApplication::paletteChanged() 或 QScreen::logicalDotsPerInchChanged(),触发图标重载
  • 避免跨线程传递 HICON —— GDI 对象非线程安全,必须在 GUI 线程中创建和销毁

获取特殊系统项图标(如“回收站”“网络”)要用 CLSID

像“回收站”“网络”这类虚拟文件夹没有真实路径,必须用其 CLSID 调用 SHGetFileInfo。常见 CLSID 必须硬编码,且不同 Windows 版本略有差异:

  • 回收站:"{645FF040-5081-101B-9F08-00AA002F954E}"
  • 网络:"{F02C1A0D-BE21-4350-88B0-7367FC96EF3C}"(Win10+)或 "{208D2C60-3AEA-1069-A2D7-08002B30309D}"(旧版)
  • 控制面板:"{21EC2020-F9EB-4DB2-8813-7A759532D287}"

传入 CLSID 字符串时,uFlags 必须包含 SHGFI_PIDL,且 pszPath 实际是 PIDL(但用字符串形式传 CLSID 时,API 内部会解析),此时 dwFileAttributes 无意义,设 0 即可。

CLSID 不可用时 SHGetFileInfo 返回 0,需 fallback 到默认图标,别让界面卡死或崩溃。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2268

2024.03.14

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

1039

2024.03.14

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

447

2024.03.14

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

327

2024.03.14

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

426

2024.03.14

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

600

2024.03.14

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

1429

2024.03.21

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

1237

2024.03.22

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

60

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Conan 2 安装指南
Conan 2 安装指南

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn