LoadIcon

小甲鱼

注：本文档由 TOP_LK 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

LoadIcon 函数用于从一个与应用程序实例相关联的可执行文件中载入指定的图标资源。

注意：该函数已被 LoadImage 函数取代。


API 函数原型：

注释：_In_ 说明该参数是输入的，_In_opt_ 说明该参数是输入同时是可选的。

HICON WINAPI LoadIcon(
  _In_opt_ HINSTANCE hInstance,
  _In_     LPCTSTR   lpIconName
);

参数解析：

参数	含义
hInstance	1. 一个模块的实例句柄，该模块的可执行文件包含要加载的图标 2. 当一个标准的图标被加载时，此参数一定是 NULL
lpIconName	1. 指定要加载的图标资源的名称 2. 该参数可以在低位字中包含资源标识符，在高位字中包含 0 3. 使用 MAKEINTRESOURCE 宏来创建该值 4. 如果要使用预定义的图标，将 hInstance 参数的值设置为 NULL，lpIconName 参数可以为下值之一： 值 含义 IDI_APPLICATION MAKEINTRESOURCE(32512) 默认的应用程序图标 IDI_ASTERISK MAKEINTRESOURCE(32516) 星号图标，同 IDI_INFORMATION IDI_ERROR MAKEINTRESOURCE(32513) 手形图标 IDI_EXCLAMATION MAKEINTRESOURCE(32515) 感叹号图标，同 IDI_WARNING IDI_HAND MAKEINTRESOURCE(32513) 手形图标，同 IDI_ERROR IDI_INFORMATION MAKEINTRESOURCE(32516) 星号图标 IDI_QUESTION MAKEINTRESOURCE(32514) 问号图标 IDI_SHIELD MAKEINTRESOURCE(32518) 安全屏蔽图标 IDI_WARNING MAKEINTRESOURCE(32515) 感叹号图标 IDI_WINLOGO MAKEINTRESOURCE(32517) 默认的应用程序图标 Windows 2000: Windows logo图标

返回值：

1. 如果函数调用成功，返回值是新加载的图标的句柄；

2. 如果函数执行失败，返回值为 NULL。

3. 获取更多错误信息请调用 GetLastError 函数。


备注：

1. LoadIcon 函数加载图标资源仅仅在它还没被加载时，否则，它会得到一个现有资源的句柄。该函数搜索最适合当前显示的图标的图标资源。图标资源可以是一个彩色或单色的位图。

2. LoadIcon 函数只能加载一个尺寸符合 SM_CXICON 和 SM_CYICON 系统度量值的图标。使用 LoadImage 函数来加载其他尺寸的图标。


需求：

Minimum supported client	Windows 2000 专业版 [仅桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [仅桌面应用程序]
Header	Winuser.h (包含于 Windows.h)
Library	User32.lib
DLL	User32.dll
Unicode and ANSI name	LoadIconW (Unicode) 和 LoadIconA (ANSI)

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。