getIconInfoExA 函数 (winuser.h)
检索有关指定图标或光标的信息。 GetIconInfoEx 使用更新的 ICONINFOEX 结构扩展 GetIconInfo。
语法
BOOL GetIconInfoExA(
[in] HICON hicon,
[in, out] PICONINFOEXA piconinfo
);
参数
[in] hicon
类型: HICON
图标或光标的句柄。
若要检索有关标准图标或游标的信息,请在此参数中指定 以IDI_前缀开头 的 标识符或以IDC_前缀开头的标识符 。
[in, out] piconinfo
类型: PICONINFOEX
此方法返回时,包含指向 ICONINFOEX 结构的指针。 函数填充结构的成员。
返回值
类型: BOOL
TRUE 表示成功, FALSE 表示失败。
注解
GetIconInfoEx 为 hbmMask 和 hbmColor 或 ICONINFOEX 的成员创建位图。 调用应用程序必须管理这些位图,并在不再需要时使用 DeleteObject 调用将其删除。
DPI 虚拟化
此 API 不参与 DPI 虚拟化。 返回的输出不受调用线程的 DPI 影响。注意
winuser.h 标头将 GetIconInfoEx 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | winuser.h (包括 Windows.h) |
Library | User32.lib |
DLL | User32.dll |
请参阅
概念性
GetObject