函数原型
WINUSERAPI
HICON
WINAPI
LoadIconA(
__in_opt HINSTANCE hInstance,
__in LPCSTR lpIconName);
WINUSERAPI
HICON
WINAPI
LoadIconW(
__in_opt HINSTANCE hInstance,
__in LPCWSTR lpIconName);
#ifdef UNICODE
#define LoadIcon LoadIconW
#else
#define LoadIcon LoadIconA
#endif // !UNICODE
功能:从与hInstance模块相关联的可执行文件中装入lpIconName指定的图标资源,仅当图标资源还没有被装入时该函数才执行装入操作,否则只获取装入的资源句柄。
参数 | 说明 |
---|---|
hInstance | 句柄 |
lpIconName | 指向NULL字符结尾的字符串的指针,它包含图标名 |
注意:若使用Windows预定义的图标,hInstance 必须设置成NULL
lpIconName的值可以是:
值 | 说明 | 样式 |
---|---|---|
IDI_APPLICATION | 32512,缺省应用程序图标 | ![]() |
IDI_HAND / IDI_ERROR | 32513,停止图标 | ![]() |
IDI_QUESTION | 32514,问号图标 | ![]() |
IDI_EXCLAMATION / IDI_WARNING | 32515,惊叹号图标 | ![]() |
IDI_ASTERISK / IDI_INFORMATION | 32516,信息图标 | ![]() |
IDI_WINLOGO | 32517,Windows Logo 语言图标,在版本大于等于0x0400中使用 | ![]() |
IDI_SHIELD | 32518,安全防护罩图标,在版本大于等于0x0600中使用 | ![]() |
返回值
若成功则返回最近一次加载的图标句柄,否则返回NULL。如果标识的资源没被加载过,则加载并返回图标句柄;如果加载过,则不再重新加载,直接返回已存在的图标句柄。
其他
头文件:Winuser.h
库:User32.lib/User32.dll
限制:Windows 2000 Professional
Windows NT:3.1及以上版本
Windows:95及以上版本
Windows CE:不支持