DrawIconEx

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

 (BOOL DrawIconEx HDC  hdc, / / จัดการกับบริบทของอุปกรณ์intxLeft, / / x-พิกัดของมุมบนซ้ายintyTop, / / พิกัด y ของมุมบนซ้ายHICONhIcon, / / จัดการไอคอนการวาด intcxWidth, / / ความกว้างของไอคอน intcyWidth, / / ความสูงของไอคอนUINTistepIfAniCur, / / ดัชนีของเฟรมในการเคลื่อนไหวเคอร์เซอร์HBRUSHhbrFlickerFreeDraw, / / จัดการพื้นหลังแปรง UINTdiFlags / / ในประเทศไอคอนรูปวาด);
 

พารามิเตอร์

hdc

จัดการกับบริบทอุปกรณ์สำหรับหน้าต่าง.

xLeft

ระบุการตรรกะพิกัด x ของมุมบนซ้ายของไอคอนหรือเคอร์เซอร์.

yTop

ระบุการตรรกะพิกัด y ของมุมบนซ้ายของไอคอนหรือเคอร์เซอร์.

hIcon

จัดการไอคอนหรือเคอร์เซอร์เมื่อต้องการวาด พารามิเตอร์นี้สามารถระบุเคอร์เซอร์แบบภาพเคลื่อนไหว ทรัพยากรไอคอนหรือเคอร์เซอร์ต้องเคยโหลด โดยใช้ฟังก์ชันLoadImage.

cxWidth

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

cyWidth

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

istepIfAniCur

ระบุดัชนีของกรอบการวาด ถ้าhIconระบุเคอร์เซอร์แบบภาพเคลื่อนไหว พารามิเตอร์นี้จะถูกละเว้นถ้าhIconไม่ได้ระบุเคอร์เซอร์แบบภาพเคลื่อนไหว.

hbrFlickerFreeDraw

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

diFlags

ระบุสถานะการวาด พารามิเตอร์นี้สามารถเป็นหนึ่งในค่าต่อไปนี้:

ค่า	ความหมาย
DI_COMPAT	วาดไอคอนหรือเคอร์เซอร์ใช้รูปเริ่มต้นระบบแทนที่เป็นรูปผู้ใช้กำหนด.
DI_DEFAULTSIZE	วาดไอคอนหรือเคอร์เซอร์ใช้ความกว้างและความสูงที่กำหนด โดยระบบเมตริกค่าสำหรับเคอร์เซอร์หรือไอคอน ถ้าพารามิเตอร์cxWidthและcyWidthถูกตั้งค่าเป็นศูนย์ ถ้าไม่มีระบุค่าสถานะนี้ และcxWidthและcyWidthถูกตั้งค่าเป็นศูนย์ ฟังก์ชันการใช้ขนาดจริงทรัพยากร.
DI_IMAGE	วาดไอคอนหรือใช้รูปของเคอร์เซอร์.
DI_MASK	วาดไอคอนหรือใช้รูปแบบการเคอร์เซอร์.
DI_NORMAL	ชุดของ DI_IMAGE และ DI_MASK.

ส่งกลับค่า

ถ้าฟังก์ชันสำเร็จ ค่าส่งกลับจะไม่ใช่ศูนย์.

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

หมายเหตุ

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

Windows CE: ต้องใช้การตั้งค่าพารามิเตอร์ต่อไปนี้

• diFlagsต้องเป็น DI_NORMAL, DI_IMAGE หรือ DI_MASK (DI_COMPAT และ DI_DEFAULTSIZE ไม่สามารถใช้)
• cxWidthและcyHeightต้องเป็นค่าศูนย์หรือขนาดของไอคอนดั้งเดิม.
• hbrFlickerFreeDrawต้องเป็นค่า NULL.
• iStepIfAniCurต้องเป็นศูนย์ ไอคอนที่เคลื่อนไหวไม่ได้สนับสนุน.

ไม่สนับสนุน Windows CE:

• ยืดและการบีบอัด.

  นั่นคือ ไอคอนความละเอียดคงที่สำหรับ HICON ที่กำหนด และการปรับขนาดไอคอนไม่ได้รับการสนับสนุน.

• โหมดการแมป.
• การใช้DrawIconExเพื่อวาดเคอร์เซอร์.

พารามิเตอร์hIconไม่สามารถระบุเคอร์เซอร์แบบภาพเคลื่อนไหว.

QuickInfo

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

ดูเพิ่มเติม

รวมไอคอนไอคอนฟังก์ชัน CopyImage, DrawIcon, LoadImage

Index