CopyImage

ฟังก์ชันCopyImageสร้างรูปแบบใหม่ (ไอคอน เคอร์เซอร์ หรือบิตแมป) และคัดลอกแอตทริบิวต์ของรูปที่ระบุไปยังตำแหน่งใหม่ ถ้าจำเป็น ฟังก์ชันการยืดบิตให้พอดีกับขนาดของรูปภาพใหม่ที่ต้องการ.

( CopyImage หมายเลขอ้างอิง จัดการ hImage, / / จัดการภาพการคัดลอกUINTuType, / / ชนิดของรูปภาพที่คัดลอกintcxDesired, / / ต้องการความกว้างของรูปภาพใหม่intcyDesired, / / ต้องการความสูงของรูปภาพใหม่UINTfuFlags / / คัดลอกค่าสถานะ);
 

พารามิเตอร์

hinst
จัดการกับอินสแตนซ์ของโมดูลที่ประกอบด้วยรูปที่ต้องการคัดลอก.
uType
ระบุชนิดของรูปภาพที่ต้องการคัดลอก พารามิเตอร์นี้สามารถเป็นหนึ่งในค่าต่อไปนี้:
ค่า ความหมาย
IMAGE_BITMAP คัดลอกเป็นรูปบิตแมป.
IMAGE_CURSOR คัดลอกเคอร์เซอร์.
IMAGE_ICON ไอคอนที่คัดลอก.

cxDesired
ระบุความกว้างที่ต้องการ พิกเซล รูป.
cyDesired
ระบุความสูงที่ต้องการ พิกเซล รูป.
fuFlags
ระบุการรวมกันของค่าต่อไปนี้:
ค่า ความหมาย
LR_COPYDELETEORG ลบภาพต้นฉบับหลังจากสร้างสำเนา.
LR_COPYRETURNORG สร้างสำเนาแน่นอนของรูป ละเว้นพารามิเตอร์cxDesiredและcyDesired.
LR_MONOCHROME สร้างรูปภาพขาวดำใหม่.
LR_COPYFROMRESOURCE พยายามโหลดทรัพยากรไอคอนหรือเคอร์เซอร์จากทรัพยากรแฟ้มต้นฉบับไม่ใช่เพียงแค่คัดลอกรูปปัจจุบัน ซึ่งเป็นประโยชน์สำหรับการสร้างสำเนาที่มีขนาดแตกต่างกันเมื่อแฟ้มทรัพยากรประกอบด้วยหลายขนาดของทรัพยากร โดยไม่มีค่าสถานะนี้CopyImageยืดรูปภาพต้นฉบับขนาดใหม่ หากถูกตั้งค่าสถานะนี้CopyImageใช้ขนาดในแฟ้มทรัพยากรใกล้เคียงที่สุดกับขนาดที่ต้องการ.

นี้จะสำเร็จได้ก็ต่อเมื่อhImageถูกโหลด โดยLoadIconหรือLoadCursorหรือLoadImageด้วยค่าสถานะ LR_SHARED.


ส่งกลับค่า

ถ้าฟังก์ชันสำเร็จ ส่งคืนค่าเป็นหมายเลขอ้างอิงกับรูปสร้างขึ้นใหม่.

ถ้าฟังก์ชันล้มเหลว ส่งคืนค่าเป็น NULL การขอเพิ่มเติมข้อมูลข้อผิดพลาด โทร GetLastError.

หมายเหตุ

เมื่อเสร็จสิ้นการใช้ทรัพยากร คุณสามารถปล่อยของหน่วยความจำที่เกี่ยวข้อง โดยการเรียกฟังก์ชันหนึ่งในตารางต่อไปนี้.

ทรัพยากร ฟังก์ชันของรุ่น
บิตแมป DeleteObject
เคอร์เซอร์ DestroyCursor
ไอคอน DestroyIcon

ระบบลบทรัพยากรโดยอัตโนมัติเมื่อสิ้นสุดลงของกระบวนการ อย่างไรก็ตาม เรียกฟังก์ชันเหมาะสมช่วยประหยัดหน่วยความจำ และเป็นลดขนาดของชุดการทำงานของกระบวนการ.

QuickInfo

nbsp Windows &NT:ต้องการรุ่น 3.5 หรือรุ่นที่ใหม่กว่า
Windows:ต้องใช้ Windows 95 หรือรุ่นที่ใหม่กว่า
Windows CE:ไม่สนับสนุน
หัวข้อ:ประกาศใน winuser.h
ไลบรารีที่นำเข้า:ใช้ user32.lib.

ดูเพิ่มเติม

ภาพรวมของทรัพยากรฟังก์ชันทรัพยากร LoadImage

Index