createIconFromResourceEx 函数 (winuser.h)

项目
02/01/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

DWORD 对齐缓冲区指针，其中包含图标 (RT_ICON) 或光标 (RT_CURSOR) 资源位。这些位通常是通过调用 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

图标或光标的高度（以像素为单位）。如果此参数为零且 Flags 参数 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 应用程序和图标浏览器检查和使用整个系统的资源。

对于图标，应调用 DestroyIcon;对于使用 CreateIconFromResourceEx 创建的游标，应调用 DestroyCursor。

示例

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

要求

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