LoadCursor

ฟังก์ชันLoadCursorโหลดทรัพยากรที่ระบุเคอร์เซอร์จากการปฏิบัติ (ไฟล์ EXE) ที่เกี่ยวข้องกับอินสแตนซ์ของแอพลิเคชัน.

ฟังก์ชันนี้ได้ถูกแทนที่ โดยฟังก์ชันLoadImage

(HCURSOR LoadCursor HINSTANCE  hInstance, / / จัดการกับอินสแตนซ์ของแอพลิเคชันLPCTSTRlpCursorName / / ชื่อตัวระบุทรัพยากรสตริหรือเคอร์เซอร์);
 

พารามิเตอร์

hInstance
จัดการกับอินสแตนซ์ของแฟ้มปฏิบัติการได้ประกอบด้วยการให้เคอร์เซอร์สามารถโหลดโมดูล.
lpCursorName
ชี้การสตริสิ้นสุดด้วยค่า null ซึ่งประกอบด้วยชื่อของทรัพยากรเคอร์เซอร์จะโหลด อีกวิธีหนึ่งคือ พารามิเตอร์นี้สามารถประกอบด้วยตัวระบุทรัพยากรในคำว่าใบสั่งต่ำและศูนย์ในคำสูงใบสั่ง แมโคMAKEINTRESOURCEยังสามารถใช้เพื่อสร้างค่านี้.

การใช้วิธีการใดวิธีการหนึ่งเคอร์เซอร์ Win32 ที่กำหนดไว้ล่วงหน้าของ แอพลิเคชันต้องตั้งค่าพารามิเตอร์hInstanceเป็น NULL และพารามิเตอร์lpCursorNameเป็นหนึ่งในค่าต่อไปนี้:
ค่า คำอธิบาย
IDC_APPSTARTING ลูกศรที่มาตรฐานและนาฬิกาทรายขนาดเล็ก
IDC_ARROW ลูกศรที่มาตรฐาน
IDC_CROSS Crosshair
IDC_HAND Windows NT 5.0 และรุ่นใหม่กว่า: มือ
IDC_HELP ลูกศรและเครื่องหมายคำถาม
IDC_IBEAM รูปตัว I
IDC_ICON Obsolete สำหรับโปรแกรมประยุกต์ที่ทำเครื่องหมายเวอร์ชัน 4.0 หรือรุ่นที่ใหม่กว่า.
IDC_NO วงกลม slashed
IDC_SIZE Obsolete สำหรับโปรแกรมประยุกต์ที่ทำเครื่องหมายเวอร์ชัน 4.0 หรือรุ่นที่ใหม่กว่า ใช้ IDC_SIZEALL.
IDC_SIZEALL ศรสี่หัวชี้เหนือ ใต้ ทิศตะวัน ออก และทิศตะวันตก
IDC_SIZENESW หัวลูกศรชี้ northeast และตะวันตกเฉียงใต้
IDC_SIZENS หัวลูกศรชี้ทางทิศเหนือและใต้
IDC_SIZENWSE หัวลูกศรชี้ตะวันตกเฉียงและตะวันออกเฉียงใต้
IDC_SIZEWE หัวลูกศรชี้ตะวันตกและตะวันออก
IDC_UPARROW ลูกศรแนวดิ่ง
IDC_WAIT นาฬิกาทราย

ส่งกลับค่า

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

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

หมายเหตุ

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

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

Windows CE: ใช้คอมโพเนนต์ของเคอร์เซอร์เมื่อกำหนดเป้าหมายเป็นแพลตฟอร์มที่ไม่สนับสนุนเคอร์เซอร์ของเมาส์ คอมโพเนนต์นี้สนับสนุนเคอร์เซอร์เดียวเป็นเคอร์เซอร์รอ (IDC_WAIT) ใช้ฟังก์ชันLoadCursorร่วมกับฟังก์ชันSetCursorเพื่อตั้งค่าเคอร์เซอร์รอ.

SetCursor (LoadCursor (NULL, IDC_WAIT))

ใช้คอมโพเนนต์ mcursor เมื่อกำหนดเป้าหมายแพลตฟอร์มที่สนับสนุนเคอร์เซอร์ของเมาส์ คอมโพเนนต์นี้สนับสนุนฟังก์ชันLoadCursorจะทำแพลตฟอร์มเดสก์ทอป Windows ด้วยวิธีเดียวกันยกเว้นว่าสนับสนุนเคอร์เซอร์รูปขาวดำเท่านั้น Windows CE สนับสนุนเคอร์เซอร์สี ความพยายามที่จะโหลดเคอร์เซอร์สีจะมีผลลัพธ์ที่ไม่อาจคาดเดา.

ดูเพิ่มเติม

ภาพรวมของเคอร์เซอร์ฟังก์ชันเคอร์เซอร์ LoadImage, MAKEINTRESOURCE, SetCursor, SetCursorPos, ShowCursor

Index