CreateIconFromResource 函数 (winuser.h)
从描述图标的资源位创建图标或光标。
若要指定所需的高度或宽度,请使用 CreateIconFromResourceEx 函数。
语法
HICON CreateIconFromResource(
[in] PBYTE presbits,
[in] DWORD dwResSize,
[in] BOOL fIcon,
[in] DWORD dwVer
);
参数
[in] presbits
类型: PBYTE
包含图标或游标资源位的 DWORD 对齐缓冲区指针。 通常通过调用 LookupIconIdFromDirectory、 LookupIconIdFromDirectoryEx 和 LoadResource 函数来加载这些位。
有关 图标和游标资源 格式的详细信息,请参阅游标和图标资源。
[in] dwResSize
类型:DWORD
presbits 参数指向的位集的大小(以字节为单位)。
[in] fIcon
类型: BOOL
指示是要创建图标还是游标。 如果此参数为 TRUE,则创建图标。 如果为 FALSE,则创建游标。
LOCALHEADER 结构定义游标热点,是从游标资源位读取的第一个数据。
[in] dwVer
类型:DWORD
presbits 参数指向的资源位的图标或光标格式的版本号。 该值必须大于或等于 0x00020000 且小于或等于 0x00030000。 此参数通常设置为 0x00030000。
返回值
类型: HICON
如果函数成功,则返回值是图标或游标的句柄。
如果函数失败,则返回值为 NULL。 要获得更多的错误信息,请调用 GetLastError。
注解
CreateIconFromResource、CreateIconFromResourceEx、CreateIconIndirect、GetIconInfo、LookupIconIdFromDirectory 和 LookupIconIdFromDirectoryEx 函数允许 shell 应用程序和图标浏览器在整个系统中检查和使用资源。
CreateIconFromResource 函数调用 CreateIconFromResourceEx 作为LR_DEFAULTSIZE|LR_SHARED
标志传递。
对于图标,应调用 DestroyIcon;对于使用 CreateIconFromResource 创建的游标,应调用 DestroyCursor。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | winuser.h (包括 Windows.h) |
Library | User32.lib |
DLL | User32.dll |
请参阅
概念性
引用