GetKeyState

ฟังก์ชันGetKeyStateดึงข้อมูลสถานะของคีย์ที่ระบุการเสมือน สถานะระบุว่า คีย์จะอัพ ลง หรือ toggled (บน ปิด — สลับในแต่ละครั้งที่มีกดปุ่ม).

(GetKeyStateสั้น int  nVirtKey / / เสมือนคีย์รหัส);
 

พารามิเตอร์

nVirtKey

ระบุคีย์แบบเสมือน ถ้าคีย์การเสมือนที่ต้องเป็นตัวอักษรหรือตัวเลข (A ถึง Z, a ถึง z หรือ 0 ถึง 9), nVirtKeyต้องถูกตั้งค่าเป็นค่า ASCII ของอักขระนั้น สำหรับแป้นอื่น ๆ มันต้องเป็นรหัสคีย์เสมือน.

หากมีใช้เค้าโครงแป้นพิมพ์ภาษาอังกฤษไม่ใช่ แป้นเสมือนกับค่าในช่วง ASCII A ถึง Z และ 0 ถึง 9 ใช้ในการระบุส่วนใหญ่ของแป้นอักขระ ตัวอย่าง สำหรับเค้าโครงแป้นพิมพ์ภาษาเยอรมัน คีย์การเสมือนของค่า ASCII O (0x4F) อ้างถึงคีย์ "o" ในขณะที่ VK_OEM_1 ที่อ้างถึงคีย์ "o กับ umlaut".

ส่งกลับค่า

ค่าส่งกลับระบุสถานะของคีย์เสมือนการกำหนด เป็นดังนี้:

• ถ้าบิตการลำดับสูง 1 คีย์จะลง มิฉะนั้น จะขึ้น.
• ถ้าบิตการลำดับต่ำคือ 1 คีย์คือ toggled คีย์ เช่นตัวพิมพ์ใหญ่ล็อกคีย์ คือ toggled ถ้าเปิดอยู่ คีย์ที่ปิดอยู่ และ untoggled ถ้าบิตการต่ำลำดับเป็น 0 การสลับคีย์ของไฟ (ถ้ามี) บนแป้นพิมพ์จะเมื่อปุ่มถูก toggled และ ปิดเมื่อคีย์ที่เป็น untoggled.

หมายเหตุ

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

แอปพลิเคชันเรียกGetKeyStateในการตอบสนองต่อข้อความป้อนข้อมูลแบบแป้นพิมพ์ ฟังก์ชันนี้ดึงข้อมูลสถานะของคีย์การเมื่อมีสร้างข้อความสำหรับการป้อนค่า.

ใช้ฟังก์ชันGetKeyboardStateเพื่อเรียกข้อมูลสถานะสำหรับคีย์เสมือนทั้งหมด.

แอปพลิเคชันสามารถใช้ค่าคงที่เสมือนคีย์รหัส VK_SHIFT, VK_CONTROL และ VK_MENU เป็นค่าสำหรับพารามิเตอร์nVirtKey ซึ่งทำให้สถานะของกะ ctrl หรือคีย์ alt โดยไม่แยกระหว่างซ้ายและขวา โปรแกรมประยุกต์ยังสามารถใช้ค่าคงเสมือนคีย์รหัสต่อไปนี้เป็นค่าสำหรับnVirtKeyเพื่อแยกความแตกต่างระหว่างอินสแตนซ์ที่ซ้าย และขวาของแป้นเหล่านั้น.

ค่าเหล่านี้คงแยกซ้าย และขวาจะพร้อมใช้งานสำหรับโปรแกรมประยุกต์เฉพาะผ่านการGetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyStateและฟังก์ชันMapVirtualKey.

Windows CE: ฟังก์ชันGetKeyStateจะใช้ได้เฉพาะการตรวจสอบสถานะของคีย์ต่อไปนี้เสมือนลง

VK_CONTROL

VK_SHIFT

VK_MENU

VK_LCONTROL

VK_LSHIFT

VK_LMENU

VK_RCONTROL

VK_RSHIFT

VK_RMENU

GetKeyStateสามารถใช้ได้เฉพาะการตรวจสอบสถานะของคีย์การเสมือน VK_CAPITAL toggled.

QuickInfo

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

ดูเพิ่มเติม

ภาพรวมการป้อนข้อมูลของแป้นพิมพ์แป้นพิมพ์ป้อนฟังก์ชัน GetAsyncKeyState, GetKeyboardState, MapVirtualKey, SetKeyboardState

Index