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.

หมายเหตุ

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

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

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

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