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将使用最接近所需大小的资源文件中的大小。 只有通过LoadIcon或LoadCursor或LoadImage加载了LR_SHARED标志【画佳】,这将成功。 |
返回值
如果函数成功,则返回值是新建图像的句柄。
如果函数失败,返回值为NULL。要获取扩展错误信息,请调用GetLastError.
也可以看看