CreateCaret

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

(BOOL CreateCaret HWND  hWnd, / / จัดการเจ้าของหน้าต่างHBITMAPhBitmap, / / จัดการการแมปสำหรับรูปร่างตัวชี้เมื่อintnWidth, / / ความกว้างของตัวชี้เมื่อintnHeight / / ความสูงของตัวชี้เมื่อ);
 

พารามิเตอร์

hWnd
ระบุหน้าต่างที่เป็นเจ้าของเครื่องหมายรูปหมวก.
hBitmap
บุบิตแมปที่กำหนดรูปร่างตัวชี้เมื่อ ถ้าพารามิเตอร์นี้เป็นค่า NULL เครื่องหมายรูปหมวกเป็นของแข็ง ถ้าพารามิเตอร์นี้ (HBITMAP) 1 เครื่องหมายรูปหมวกเป็นสีเทา ถ้าพารามิเตอร์นี้เป็นตัวจัดการรูปบิตแมป เครื่องหมายรูปหมวกเป็นบิตแมปที่ระบุ หมายเลขอ้างอิงของบิตแมปต้องถูกสร้างโดยการ CreateBitmap, CreateDIBitmapหรือ LoadBitmapฟังก์ชัน.

ถ้า ตัวจัดการรูปบิตแมปhBitmap , CreateCaretละเว้นพารามิเตอร์nWidthและnHeight บิตแมปกำหนดความกว้างและความสูงของตัวเอง.

nWidth
ระบุความกว้างของเครื่องหมายรูปหมวกในหน่วยทางลอจิคัล ถ้าพารามิเตอร์นี้เป็นศูนย์ ความกว้างถูกตั้งค่าเป็นความกว้างของเส้นขอบหน้าต่างที่กำหนดโดยระบบ ถ้า ตัวจัดการรูปบิตแมปhBitmap , CreateCaretละเว้นพารามิเตอร์นี้.
nHeight
ระบุความสูง ในหน่วยทางลอจิคัล ของเครื่องหมายรูปหมวก ถ้าพารามิเตอร์นี้เป็นศูนย์ ความสูงถูกตั้งค่าเป็นความสูงของเส้นขอบหน้าต่างที่กำหนดโดยระบบ ถ้า ตัวจัดการรูปบิตแมปhBitmap , CreateCaretละเว้นพารามิเตอร์นี้.

ส่งกลับค่า

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

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

หมายเหตุ

พารามิเตอร์nWidthและnHeightระบุความกว้างและความสูง เครื่องหมายรูปหมวกของในหน่วยทางลอจิคัล ความกว้างที่แน่นอนและสูง พิกเซล ขึ้นกับโหมดการแมปของหน้าต่าง.

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

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

คุณสามารถเรียกความกว้างหรือความสูงของขอบหน้าต่างของระบบ โดยใช้ฟังก์ชันGetSystemMetricsระบุค่า SM_CXBORDER และ SM_CYBORDER การใช้ความสูงหรือความกว้างของเส้นขอบหน้าต่างรับประกันว่า เครื่องหมายรูปหมวกจะมองเห็นได้บนหน้าจอความละเอียดสูง.

Windows CE: Windows CE สนับสนุนพารามิเตอร์hBitmapและควรจะตั้งค่าให้เป็น NULL เริ่มต้น Windows CE เครื่องรูปหมวกแบบทึบ.

QuickInfo

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

ดูเพิ่มเติม

ภาพรวมของหมายตัวชี้เมื่อฟังก์ชัน CreateBitmap, CreateDIBitmap, DestroyCaret, GetSystemMetrics, HideCaret, LoadBitmap, ShowCaret

Index