LoadImage

ฟังก์ชันLoadImageโหลดไอคอน เคอร์เซอร์ หรือบิตแมป.

( LoadImage หมายเลขอ้างอิง HINSTANCE  hinst, / / หมายเลขอ้างอิงของอินสแตนซ์ที่ประกอบด้วยรูปLPCTSTRlpszName, / / ชื่อหรือรหัสของรูปภาพUINTuType, / / พิมพ์รูปภาพintcxDesired, / / ความกว้างที่ต้องการ intcyDesired, / / ต้องสูงUINTfuLoad / / โหลดค่าสถานะ);
 

พารามิเตอร์

hinst

จัดการกับอินสแตนซ์ของโมดูลที่ประกอบด้วยรูปสามารถโหลด โหลดรูป OEM กำหนดพารามิเตอร์นี้เป็นศูนย์.

lpszName

จัดการภาพโหลด.

ถ้าพารามิเตอร์hinstไม่ใช่ NULL และพารามิเตอร์fuLoadไม่มี LR_LOADFROMFILE, lpszNameเป็นตัวชี้การสตริสิ้นสุดด้วยค่า null ซึ่งประกอบด้วยชื่อของทรัพยากรรูปในโมดูลhinst.

ถ้าhinstเป็น NULL และไม่มีระบุ LR_LOADFROMFILE คำต่ำใบสั่งของพารามิเตอร์นี้ต้องเป็นตัวระบุของรูป OEM โหลด มีกำหนดตัวบ่งชี้ที่รูป OEM ใน WINUSERH และมี prefixes ต่อไปนี้:

คำนำหน้า	ความหมาย
OBM_	บิตแมปของ OEM
OIC_	ไอคอนของ OEM
OCR_	เคอร์เซอร์ของ OEM

ถ้าพารามิเตอร์fuLoadมีค่า LR_LOADFROMFILE, lpszNameคือชื่อของแฟ้มที่ประกอบด้วยรูป.

uType

ระบุชนิดของภาพที่จะสามารถโหลด พารามิเตอร์นี้สามารถเป็นหนึ่งในค่าต่อไปนี้:

ค่า	ความหมาย
IMAGE_BITMAP	โหลดบิตแมป.
IMAGE_CURSOR	โหลดเคอร์เซอร์.
IMAGE_ICON	โหลดไอคอน.

cxDesired

ระบุความกว้าง พิกเซล ไอคอนหรือเคอร์เซอร์ ถ้าพารามิเตอร์นี้เป็นศูนย์ และพารามิเตอร์fuLoad LR_DEFAULTSIZE ฟังก์ชันการใช้ SM_CXICON หรือ SM_CXCURSOR ระบบเมตริกค่าการตั้งค่าความกว้าง ถ้าพารามิเตอร์นี้เป็นศูนย์ และไม่มีใช้ LR_DEFAULTSIZE ฟังก์ชันใช้ความกว้างจริงของทรัพยากร.

cyDesired

ระบุความสูง พิกเซล ไอคอนหรือเคอร์เซอร์ ถ้าพารามิเตอร์นี้เป็นศูนย์ และพารามิเตอร์fuLoad LR_DEFAULTSIZE ฟังก์ชันการใช้ SM_CYICON หรือ SM_CYCURSOR ระบบเมตริกค่าการตั้งค่าความสูง ถ้าพารามิเตอร์นี้เป็นศูนย์ และไม่มีใช้ LR_DEFAULTSIZE ฟังก์ชันการใช้ความสูงของทรัพยากรที่แท้จริง.

fuLoad

ระบุการรวมกันของค่าต่อไปนี้:

ค่า	ความหมาย
LR_DEFAULTCOLOR	ตั้งค่าสถานะเริ่มต้น มันไม่อะไร ทั้งหมดที่หมายถึงคือ "ไม่ LR_MONOCHROME".
LR_CREATEDIBSECTION	เมื่อพารามิเตอร์uTypeระบุ IMAGE_BITMAP ทำให้ฟังก์ชันจะส่งกลับบิตแมป DIB ส่วนแทนที่เป็นบิตแมปเข้ากันได้ ธงนี้มีประโยชน์สำหรับการโหลดบิตแมปโดยไม่ต้องแมปกับสีของอุปกรณ์แสดงผล.
LR_DEFAULTSIZE	ใช้ความกว้างหรือความสูงที่กำหนด โดยระบบเมตริกค่าสำหรับเคอร์เซอร์หรือไอคอน ถ้าค่าcxDesiredหรือcyDesiredถูกตั้งค่าเป็นศูนย์ ถ้าไม่มีระบุค่าสถานะนี้ และcxDesiredและcyDesiredถูกตั้งค่าเป็นศูนย์ ฟังก์ชันการใช้ขนาดแท้จริงของทรัพยากร ถ้าทรัพยากรประกอบด้วยหลายรูป ฟังก์ชันการใช้ขนาดของรูปแรก.
LR_LOADFROMFILE	โหลดรูปภาพจากแฟ้มที่ระบุ โดยพารามิเตอร์lpszName ถ้าไม่ระบุค่าสถานะนี้lpszNameคือชื่อของทรัพยากร.
LR_LOADMAP3DCOLORS	ตารางสีสำหรับรูปในการค้นหา และแทนที่แรเงาสีเทาต่อไปนี้ ด้วยสี 3D ที่สอดคล้องกัน:

	สี	แทนที่ด้วย
	สีเทา Dk RGB(128,128,128)	COLOR_3DSHADOW
	สีเทา RGB(192,192,192)	COLOR_3DFACE
	Lt สีเทา RGB(223,223,223)	COLOR_3DLIGHT

LR_LOADTRANSPARENT	ดึงค่าสีของพิกเซลในรูปแรก และแทนที่รายการที่สอดคล้องกันในตารางสี ด้วยสีหน้าต่างเริ่มต้น (COLOR_WINDOW) พิกเซลทั้งหมดในรูปที่ใช้รายการที่กลายเป็น สีหน้าต่างเริ่มต้น ค่านี้ใช้ได้เฉพาะรูปที่มีตารางสีที่เกี่ยวข้อง. ถ้าfuLoadมีค่าทั้ง LR_LOADTRANSPARENT และ LR_LOADMAP3DCOLORS, LRLOADTRANSPARENT จะมีความสำคัญ อย่างไรก็ตาม รายการตารางสีจะถูกแทนที่ ด้วย COLOR_3DFACE แทนที่เป็น COLOR_WINDOW.
LR_MONOCHROME	โหลดรูปขาวดำ.
LR_SHARED	หุ้นจับภาพถ้ารูปภาพถูกโหลดหลายครั้ง ถ้าไม่มีการตั้งค่า LR_SHARED สายที่สองเพื่อLoadImageสำหรับทรัพยากรเดียวกันจะโหลดรูปภาพอีกครั้ง และกลับตัวจัดการที่แตกต่างกัน. ไม่ได้ใช้ LR_SHARED สำหรับรูปภาพที่มีขนาดมาตรฐาน ที่อาจเปลี่ยนแปลงได้หลังจากโหลด หรือที่ถูกโหลดจากแฟ้ม. Windows 95 และ Windows 98: ฟังก์ชันการค้นหารูปแรก มีชื่อทรัพยากรที่ร้องขอในแคชของ โดยไม่คำนึงถึงขนาดร้องขอ.
LR_VGACOLOR	ใช้สี VGA จริง.

ส่งกลับค่า

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

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

หมายเหตุ

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

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

Windows CE: พารามิเตอร์cxDesiredและcyDesiredต้องเป็นศูนย์สำหรับ IMAGE_BITMAP.

ไม่มีสนับสนุน Windows CE ยืด และการลดขนาดของไอคอน.

พารามิเตอร์fuLoadต้องเป็นศูนย์ (== LR_DEFAULTCOLOR).

ถ้าคุณกำลังกำหนดเป้าหมายเป็นแพลตฟอร์มที่ไม่สนับสนุนเคอร์เซอร์ของเมาส์ คุณไม่สามารถระบุค่า SM_CXCURSOR และ SM_CYCURSOR ในพารามิเตอร์cxDesiredและcyDesiredและคุณไม่สามารถระบุ IMAGE_CURSOR สำหรับพารามิเตอร์uType.

ถ้าคุณกำลังกำหนดเป้าหมายเป็นแพลตฟอร์มที่สนับสนุนเคอร์เซอร์ของเมาส์ คุณสามารถระบุ SM_CXCURSOR และ SM_CYCURSOR ในcxDesiredและพารามิเตอร์cyDesiredและ IMAGE_CURSOR ในพารามิเตอร์uType.

QuickInfo

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

ดูเพิ่มเติม

ภาพรวมของทรัพยากรทรัพยากรฟังก์ชัน CopyImage, GetSystemMetrics, LoadBitmap, LoadCursor, LoadIcon

Index