导航:  Windows Procedures >

AfxLoadIconMetric

上一页返回章节概述下一页

描述

 

使用指定的系统度量加载指定的图标资源.

 

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