CopyImage

【勇芳软件工作室】汉化HomePreviousNext

CopyImage函数创建一个新图像(图标,光标或位图),并将指定图像的属性复制到新图像。如果需要,该函数将该位延伸以适应新图像的所需大小。

手柄CopyImage(

HANDLE 【画佳】,//处理要复制的图像
UINT 【UTYPE】,//要复制的图像类型
INT 【cxDesired】,//所需的新图像宽度
INT 【cyDesired】,//所需的新图像高度
UINT 【fuFlags】//复制标记
); 

参数

【HINST】

标识包含要复制的图像的模块的实例。

【UTYPE】

指定要复制的图像的类型。此参数可以是以下值之一:

含义
IMAGE_BITMAP复制位图。
IMAGE_CURSOR复制光标。
IMAGE_ICON复制一个图标。

【cxDesired】

指定图像所需的宽度(以像素为单位)。

【cyDesired】

指定图像所需的高度(以像素为单位)。

【fuFlags】

指定以下值的组合:

含义
LR_COPYDELETEORG创建副本后,删除原始图像。
LR_COPYRETURNORG创建图像的精确副本,忽略【cxDesired】【cyDesired】参数。
LR_MONOCHROME创建一个新的单色图像。
LR_COPYFROMRESOURCE尝试从原始资源文件重新加载图标或游标资源,而不是简单地复制当前图像。当资源文件包含资源的多个大小时,这对于创建不同大小的副本非常有用。没有这个标志,CopyImage将原始图像延伸到新尺寸。如果设置了此标志,CopyImage将使用最接近所需大小的资源文件中的大小。

只有通过LoadIconLoadCursorLoadImage加载了LR_SHARED标志【画佳】,这将成功。


返回值

如果函数成功,则返回值是新建图像的句柄。

如果函数失败,返回值为NULL。要获取扩展错误信息,请调用GetLastError.

也可以看看

LoadImage