描述
使用指定的系统度量加载指定的图标资源.
FreeBASIC 语法
FUNCTION AfxLoadIconMetric ( _ BYVAL hinst AS HINSTANCE, _ BYVAL pwszName AS WSTRING PTR, _ BYVAL lims AS LONG, _ BYVAL phico AS HICON PTR _ ) AS HRESULT |
参数
hinst |
[in]句柄是DLL或可执行模块(.exe)文件包含要加载的图标.更多信息,见GetModuleHandle. To load a predefined icon or a standalone icon file, set this parameter to NULL. |
pwszName |
[in]指向以null结尾的,包含Unicode缓冲加载的图标的位置信息.其解释如下:
If hinst is NULL, pszName can specify one of two things.
1) The identifier of a predefined icon to load. These identifiers are recognized.
IDI_APPLICATION IDI_INFORMATION IDI_ERROR IDI_WARNING IDI_SHIELD IDI_QUESTION 通过这些常数的AfxLoadIconMetric功能,使用MAKEINTRESOURCE宏.例如,加载IDI_ERROR图标,通过MAKEINTRESOURCE(idi_error)为pszName参数和NULL为hinst参数.
2) The name of a standalone icon (.ico) file.
如果hinst非空,pszName可以指定两件事之一.
1)图标资源的名称,如果要从模块中加载图标资源. 2)图标序号,如果图标资源是由顺序加载模块.这个顺序必须采用MAKEINTRESOURCE宏包装. |
lims |
[in]所需的度量.下列值之一: LIM_SMALL 对应于SM_CXSMICON,推荐像素宽度的一个小图标. LIM_LARGE 对应于SM_CXICON,一个图标的默认像素宽度. |
phico |
[out]当这个函数返回时,包含一个指针指向的加载图标的句柄. |
返回值
返回S_OK如果成功,否则出错,包括以下值.
E_INVALIDARG
该缓冲区的内容所指向的pszname不适合任何预期的解释.
备注
LoadIconMetric LoadIcon相似,但与能力来指定图标的度量.它是用来代替LoadIcon时调用的应用程序要保证高质量的图标.这是特别有用的高点每英寸(DPI)的情况.
图标提取或创建如下.
1)如果在资源中找到确切的大小匹配,则使用该图标.
2)如果找不到精确的尺寸匹配和较大的图标,则通过将较大的版本缩小到所需的大小来创建新图标.
3)如果找不到精确的尺寸匹配,没有较大的图标可用,则通过将较小的图标缩放到所需的大小来创建新图标.
引用文件
AfxWin.inc