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.

หมายเหตุ

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

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

QuickInfo

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

ดูเพิ่มเติม

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

Index