getIconInfo 函数 (winuser.h)

检索有关指定图标或光标的信息。

语法

BOOL GetIconInfo(
  [in]  HICON     hIcon,
  [out] PICONINFO piconinfo
);

参数

[in] hIcon

类型: HICON

图标或光标的句柄。

若要检索有关标准图标或游标的信息,请在此参数中指定 以IDI_前缀开头标识符或以IDC_前缀开头的标识符

[out] piconinfo

类型: PICONINFO

指向 ICONINFO 结构的指针。 函数填充结构的成员。

返回值

类型: BOOL

如果函数成功,则返回值为非零值,并且函数将填充指定 ICONINFO 结构的成员。

如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。

注解

GetIconInfohbmMaskhbmColorICONINFO 的成员创建位图。 调用应用程序必须管理这些位图,并在不再需要时使用 DeleteObject 调用将其删除。

DPI 虚拟化

此 API 不参与 DPI 虚拟化。 返回的输出不受调用线程的 DPI 影响。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 在 Windows 8) 中引入的 ext-ms-win-ntuser-gui-l1-1-0 (

请参阅

概念性

位图

图标

DeleteObject

GetObject

BITMAP

CreateIcon

CreateIconFromResource

CreateIconIndirect

DestroyIcon

DrawIcon

DrawIconEx

LoadIcon

LookupIconIdFromDirectory

ICONINFO