LoadIcon函数从与应用程序实例关联的可执行文件(.EXE)文件加载指定的图标资源。
惠康LoadIcon(
HINSTANCE 【的hInstance】, | //应用程序实例的句柄 |
LPCTSTR 【lpIconName】 | //图标名称字符串或图标资源标识符 |
); |
参数
【的hInstance】
标识可执行文件包含要加载的图标的模块实例。加载标准图标时,此参数必须为NULL。
【lpIconName】
指向一个以null结尾的字符串,其中包含要加载的图标资源的名称。或者,该参数可以包含低位字中的资源标识符和高位字中的零。使用MAKEINTRESOURCE宏创建此值。
要使用其中一个Windows预定义的图标,请将【的hInstance】参数设置为NULL,将【lpIconName】参数设置为以下值之一:
值 | 描述 |
IDI_APPLICATION | 默认应用程序图标。 |
IDI_ASTERISK | 星号(用于信息性消息)。 |
IDI_EXCLAMATION | 感叹号(用于警告消息)。 |
IDI_HAND | 手形图标(用于严重警告信息)。 |
IDI_QUESTION | 问号(用于提示信息)。 |
IDI_WINLOGO | Windows徽标。 |
返回值
如果函数成功,则返回值是新加载的图标的句柄。
如果函数失败,返回值为NULL。要获取扩展错误信息,请调用GetLastError.
备注
LoadIcon仅在图标资源尚未加载时加载图标资源;否则,它将检索现有资源的句柄。该函数将搜索图标资源中最适合当前显示的图标。图标资源可以是彩色或单色位图。
LoadIcon只能加载大小符合SM_CXICON和SM_CYICON系统度量值的图标。使用LoadImage功能加载其他尺寸的图标。
也可以看看