如何获取输入值对应的win32api虚拟键码？

问题根源 #

win32api.VkKeyScan() 仅支持传入单个Unicode字符，所以传入'alt'这类多字符字符串会触发TypeError。它的设计初衷是映射字母、数字这类可打印字符到虚拟键码，没法直接处理Shift、Ctrl、Alt这类功能按键。

解决方案 #

1. 直接使用预定义的虚拟键码常量

Win32API通过win32con模块提供了所有功能按键的虚拟键码常量，直接调用即可，无需转换：

import win32api
import win32con

# 检测Alt键是否按下（VK_MENU对应Alt键）
if win32api.GetKeyState(win32con.VK_MENU) < 0:
    print("Alt键处于按下状态")

# 检测Ctrl键
if win32api.GetKeyState(win32con.VK_CONTROL) < 0:
    print("Ctrl键处于按下状态")

# 检测Shift键
if win32api.GetKeyState(win32con.VK_SHIFT) < 0:
    print("Shift键处于按下状态")

2. 字母/数字字符转虚拟键码

对于字母、数字这类单个字符，依然可以用VkKeyScan()，但需要提取返回值的低字节（虚拟键码本身），高字节存储的是Shift/Ctrl/Alt的修饰状态：

# 转换字符'A'到虚拟键码
vk_result = win32api.VkKeyScan('A')
vk_code = vk_result & 0xFF  # 提取低字节的虚拟键码
modifier_state = (vk_result >> 8) & 0xFF  # 提取高字节的修饰键状态

print(f"A的虚拟键码: {hex(vk_code)}")
print(f"修饰键状态: {modifier_state}")  # 对应Shift/Ctrl/Alt的组合状态

3. 输入框内容的统一映射

如果要处理输入框中用户输入的字符串（比如'alt'、'a'），可以做一个映射字典，把输入字符串对应到对应的虚拟键码：

key_mapping = {
    # 功能按键
    'alt': win32con.VK_MENU,
    'ctrl': win32con.VK_CONTROL,
    'shift': win32con.VK_SHIFT,
    'enter': win32con.VK_RETURN,
    'space': win32con.VK_SPACE,
    # 字母按键
    'a': win32api.VkKeyScan('a') & 0xFF,
    'u': win32api.VkKeyScan('u') & 0xFF,
    # 可扩展更多按键...
}

# 模拟处理输入框内容
input_content = 'alt'
vk_code = key_mapping.get(input_content)

if vk_code:
    if win32api.GetKeyState(vk_code) < 0:
        print(f"{input_content}键已按下")
    # 配合pyautogui执行操作示例
    # pyautogui.click()  # 当按键按下时执行点击

注意事项 #

• win32api.GetKeyState()返回的是短整型值，小于0表示按键当前处于按下状态；
• win32con模块包含了所有官方定义的虚拟键码常量，比手动记十六进制值更可靠；
• 若需要模拟按键输入，也可以直接用pyautogui的press()、hotkey()方法，无需手动处理虚拟键码，但如果必须结合GetKeyState()检测状态，上述方法适用。

内容的提问来源于stack exchange，提问作者jush456