CreateIconFromResource 函数 (winuser.h)

从描述图标的资源位创建图标或光标。

若要指定所需的高度或宽度,请使用 CreateIconFromResourceEx 函数。

语法

HICON CreateIconFromResource(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer
);

参数

[in] presbits

类型: PBYTE

包含图标或游标资源位的 DWORD 对齐缓冲区指针。 通常通过调用 LookupIconIdFromDirectoryLookupIconIdFromDirectoryExLoadResource 函数来加载这些位。

有关 图标和游标资源 格式的详细信息,请参阅游标和图标资源。

[in] dwResSize

类型:DWORD

presbits 参数指向的位集的大小(以字节为单位)。

[in] fIcon

类型: BOOL

指示是要创建图标还是游标。 如果此参数为 TRUE,则创建图标。 如果为 FALSE,则创建游标。

LOCALHEADER 结构定义游标热点,是从游标资源位读取的第一个数据。

[in] dwVer

类型:DWORD

presbits 参数指向的资源位的图标或光标格式的版本号。 该值必须大于或等于 0x00020000 且小于或等于 0x00030000。 此参数通常设置为 0x00030000。

返回值

类型: HICON

如果函数成功,则返回值是图标或游标的句柄。

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

注解

CreateIconFromResourceCreateIconFromResourceExCreateIconIndirectGetIconInfoLookupIconIdFromDirectoryLookupIconIdFromDirectoryEx 函数允许 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

请参阅

概念性

CreateIconFromResourceEx

CreateIconIndirect

GetIconInfo

图标

LoadResource

LookupIconIdFromDirectory

LookupIconIdFromDirectoryEx

引用