LoadIcon
注:本文档由 TOP_LK 翻译,小甲鱼校对。原文链接 -> 传送门
函数功能:
LoadIcon 函数用于从一个与应用程序实例相关联的可执行文件中载入指定的图标资源。
注意:该函数已被 LoadImage 函数取代。
API 函数原型:
注释:_In_ 说明该参数是输入的,_In_opt_ 说明该参数是输入同时是可选的。
HICON WINAPI LoadIcon(
_In_opt_ HINSTANCE hInstance,
_In_ LPCTSTR lpIconName
);
参数解析:
参数 含义
hInstance1. 一个模块的实例句柄,该模块的可执行文件包含要加载的图标
2. 当一个标准的图标被加载时,此参数一定是 NULL
lpIconName1. 指定要加载的图标资源的名称
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 nameLoadIconW (Unicode) 和 LoadIconA (ANSI)
【API档案】版权归鱼C工作室(www.fishc.com)所有,转载请注明来源。
页:
[1]