捐助郴维网
感谢您对郴维网的支持,你的支持将是郴维网持续发展的动力!
二维码
×
当前位置:郴维网 >API档案 > 正文
29 2017.06

CopyImage

点击次数:1462 更新时间:2017-6-29 20:49:04  【打印此页

原文链接 -> 传送门

函数功能:

Copylmage 函数用于创建一个新的图像(图标、指针或位图)并复制指定图像的属性给新创建的图像。如果有必要的话,这个函数还会扩充位数以满足新建图像的尺寸要求。


API 函数原型:

注释:_In_ 说明该参数是输入的。

HANDLE WINAPI CopyImage(
  _In_ HANDLE hImage,
  _In_ UINT   uType,
  _In_ int    cxDesired,
  _In_ int    cyDesired,
  _In_ UINT   fuFlags
);



参数解析:
 

参数

含义

hImage

指向被复制图像的句柄

uType

被复制图像的类型。这个参数可以赋予以下值:

含义

IMAGE_BITMAP(0)

复制一个位图

IMAGE_CURSOR(2)

复制一个光标

IMAGE_ICON(1)

复制一个图标

cxDesired

设定所想得到的图片像素宽度,如果这个值设为 0,那么生成的图像与 hImage 指针所指向的原始图像具有相同的宽度

cyDesired

设定所想得到的图片像素高度,如果这个值设为 0,那么生成的图像与 hImage 指针所指向的原始图像具有相同的高度

fuFlags

这个参数可以赋予以下值:

含义

LR_COPYDELETEORG
(0x00000008)

在创建新的图像之后删除原始图像

LR_COPYFROMRESOURCE
(0x00004000)

1. 试图从原始资源文件中重新加载图标或光标资源,而不是简单地复制当前图像
2. 当资源文件中包含多个尺寸的资源时,这种做法对创建不同尺寸的拷贝是有非常用的
3. 没有指定此标识参数,CopyImage 函数将拉伸原始图像至新的大小
4. 如果指定此标识参数,CopyImage 函数使用最接近所需尺寸的资源文件中的尺寸
5. 这只有当 hImage 参数被 LoadIcon 或 LoadCursor 函数调用,或拥有 LR_SHARED 标识的 LoadImage 函数调用时才能成功

LR_COPYRETURNORG
(0x00000004)

如果它满足为复制标准(也就是说,正确的尺寸和颜色深度),返回原始 hImage 参数。在这种情况下 LR_COPYDELETEORG 标识将被忽略的。如果没有指定此标识参数,总是会创建一个新的对象

LR_CREATEDIBSECTION
(0x00002000)

如果设置并创建一个新的位图,该位图被作为一个 DIB 部分创建的。否则,该位图图像作为从属设备的位图创建。只有当 UTYPE 是 IMAGE_BITMAP 格式时,这个标识参数才有效

LR_DEFAULTSIZE
(0x00000040)

如果 cxDesired 或 cyDesired 参数的值被设置为 0,将使用由系统为光标或图标指定的宽度或高度。如果没有指定这个标识参数,并且 cxDesired 和 cyDesired 的值设置为 0,该函数将调用实际资源的尺寸。如果资源包含多个图像,该函数将调用第一个图像的尺寸

LR_MONOCHROME
(0x00000001)

创建一个新的单色图像



返回值:

1. 如果函数调用成功,返回值是指向新创建图像的句柄;

2. 如果函数调用失败,返回值是 NULL。

获取有关错误的更多信息,请调用 GetLastError 函数。


备注:

当你完成资源的使用后,可以通过调用下表中的函数释放与其相关的内存:
 

资源

释放函数

位图(Bitmap)

DeleteObject 函数

光标(Cursor)

DestroyCursor 函数

图标(Icon)

DestroyIcon 函数


当它的过程终止时,系统会自动删除该资源。但是,调用合适的函数将节省内存并减小处理的工作集合的大小。


需求:
 

Minimum supported client

Windows 2000 [仅桌面应用程序]

Minimum supported server

Windows 2000 服务器版 [仅桌面应用程序]

Header

Winuser.h (包含于 Windows.h)

Library

User32.lib

DLL

User32.dll

提示
郴维网为您提供各类专业服务:
软件开发,电脑配件销售,WIFI路由器销售,上门电脑维修,上门安装系统,系统安装,软、硬件安装,电脑除尘清灰,显示器维修,WIFI安装调试,服务器维护,数据恢复,密码破解,网络布线,网络检修,打印机维修,打印机加碳粉,苹果电脑安装系统,苹果电脑安装双系统,监控安装维护,电脑外包,笔记本电脑维修,餐饮、美容行业软件安装 等。。。。。。
点击次数:1462 更新时间:2017-6-29 20:49:04  【打印此页

上一条:LoadCursorFromFile

下一条:ClipCursor

关键词推荐:郴州电脑城 郴州电脑维修公司 维修电脑公司 郴州软件开发 上门电脑维修 上门安装系统 笔记本电脑维修 郴州打印机维修 打印机加碳粉 电脑安装双系统 苹果电脑双系统 液晶显示器维修 联想笔记本维修 联想笔记本维修电话 戴尔笔记本维修电话 郴州戴尔笔记本维修 戴尔笔记本郴州维修点 华硕笔记本维修点 郴州华硕笔记本维修 郴州笔记本上网维修