CreateIconFromResourceEx 函数（winuser.h）

项目
11/20/2024

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

语法

HICON CreateIconFromResourceEx(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer,
  [in] int   cxDesired,
  [in] int   cyDesired,
  [in] UINT  Flags
);

参数

[in] presbits

类型：PBYTE

包含图标（RT_ICON）或光标（RT_CURSOR）资源位的 DWORD 对齐缓冲区指针。这些位通常是通过调用 LookupIconIdFromDirectoryEx 和 LoadResource 函数加载的。

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

[in] dwResSize

类型：DWORD

pbIconBits 参数指向的位集的大小（以字节为单位）。

[in] fIcon

类型：BOOL

指示是要创建图标还是游标。如果此参数 TRUE，则会创建一个图标。如果 FALSE，则创建游标。

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

[in] dwVer

类型：DWORD

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

[in] cxDesired

类型：int

图标或光标的宽度（以像素为单位）。如果此参数为零，并且 Flags 参数 LR_DEFAULTSIZE，则函数使用 SM_CXICON 或 SM_CXCURSOR 系统指标值设置宽度。如果此参数为零且未使用 LR_DEFAULTSIZE，则函数使用实际资源宽度。

[in] cyDesired

类型：int

图标或光标的高度（以像素为单位）。如果此参数为零，并且标志参数 LR_DEFAULTSIZE，则函数使用 SM_CYICON 或 SM_CYCURSOR 系统指标值来设置高度。如果此参数为零且未使用 LR_DEFAULTSIZE，则函数使用实际资源高度。

[in] Flags

类型：UINT

以下值的组合。

价值	意义
LR_DEFAULTCOLOR 0x00000000	使用默认颜色格式。
LR_DEFAULTSIZE 0x00000040	如果 cxDesired 或 cyDesired 值设置为零，则使用由光标或图标的系统指标值指定的宽度或高度。如果未指定此标志，并且 cxDesired 且 cyDesired 设置为零，则函数将使用实际资源大小。
LR_MONOCHROME 0x00000001	创建单色图标或光标。
LR_SHARED 0x00008000	如果多次创建图标或游标，则共享图标或游标句柄。如果未设置 LR_SHARED，则对同一资源的 CreateIconFromResourceEx 的第二次调用将再次创建图标或光标，并返回不同的句柄。使用此标志时，系统会在不再需要资源时销毁资源。不要对具有非标准大小的图标或游标使用 LR_SHARED，这些图标或游标在加载后可能会更改，或者从文件加载。

返回值

类型：HICON

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

如果函数失败，则返回值 NULL。若要获取扩展的错误信息，请调用 GetLastError。

言论

CreateIconFromResource、CreateIconFromResourceEx、CreateIconIndirect、GetIconInfo和 LookupIconIdFromDirectoryEx 函数允许 shell 应用程序和图标浏览器检查和使用整个系统的资源。

对于使用 createIconFromResourceEx创建的游标，应为图标或 DestroyCursor 调用 DestroyIcon。

例子

有关示例，请参阅共享图标资源。

要求

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
目标平台	窗户
标头	winuser.h （包括 Windows.h）
库	User32.lib
DLL	User32.dll