本教程详细阐述了在 PySimpleGUI 中如何实现键盘按键与图形用户界面 (GUI) 按钮事件的绑定。通过配置 sg.Window 启用键盘事件返回功能，并修改事件循环逻辑，开发者能够将任意键盘按键映射到特定的按钮操作，从而提升应用程序的交互性和用户体验，实现不依赖鼠标的快捷操作。
PySimpleGUI 默认事件处理机制概述
在 PySimpleGUI 中，默认的事件处理机制主要关注 GUI 元素的交互，例如按钮点击、输入框内容改变、列表项选择等。window.read() 函数通常返回由这些 GUI 元素触发的事件。这意味着，如果没有特殊配置，直接按下键盘上的某个键（例如 'h' 键），并不会被 PySimpleGUI 窗口识别为可处理的事件，除非该键是特定于系统或 PySimpleGUI 内部机制（如回车键在某些情况下）的。因此，若要实现任意键盘按键触发特定操作，需要对 PySimpleGUI 的事件捕获机制进行调整。
实现键盘按键绑定到按钮事件
要将键盘按键绑定到 PySimpleGUI 中的按钮事件，核心在于启用窗口的键盘事件捕获功能，并在事件循环中判断捕获到的键盘事件。以下是具体步骤和示例代码：
启用窗口的键盘事件返回： 在创建 sg.Window 实例时，需要将 return_keyboard_events 参数设置为 True。这将指示 PySimpleGUI 窗口在每次调用 window.read() 时，不仅返回 GUI 元素事件，还会返回任何被按下的键盘按键事件。按键事件通常以字符串形式表示，例如 'h'、'a'、'Escape' 等。
在事件循环中处理键盘事件： 在主事件循环中，当 window.read() 返回一个事件时，除了检查 GUI 元素的事件（如按钮的 key 值），还需要检查返回的事件是否与你想要绑定的键盘按键相匹配。
示例代码
以下代码演示了如何创建一个包含“Hello”按钮的窗口，并通过按下键盘上的 'h' 键来触发与点击该按钮相同的操作：
import PySimpleGUI as sg
# 1. 定义布局
# 给按钮一个唯一的key，以便在事件循环中识别它的点击事件
layout = [[sg.Button('Hello', key='-HELLO-')]]
# 2. 创建窗口，并启用键盘事件返回
# return_keyboard_events=True 使得窗口在读取事件时也会返回键盘按键事件
window = sg.Window('PySimpleGUI 键盘绑定示例', layout, return_keyboard_events=True)
# 3. 主事件循环
while True:
# 读取窗口事件和值
event, values = window.read()
# 如果窗口被关闭，则退出循环
if event == sg.WINDOW_CLOSED:
break
# 4. 处理事件
# 检查事件是否是：
# a. 按钮 '-HELLO-' 被点击（鼠标点击或在按钮有焦点时按Enter键）
# b. 键盘按键 'h' 被按下
if event == '-HELLO-' or event == 'h':
print(f'Hello, World! (事件来源: {event})')
# 5. 关闭窗口
window.close()代码解析
- sg.Button('Hello', key='-HELLO-'): 创建一个按钮，并为其指定一个唯一的 key 值 -HELLO-。这是一个良好的实践，因为它可以清晰地标识按钮事件。
- window = sg.Window('PySimpleGUI 键盘绑定示例', layout, return_keyboard_events=True): 这是实现键盘绑定的关键一步。return_keyboard_events=True 参数告诉 PySimpleGUI 捕获并返回所有键盘按键事件。
- if event == '-HELLO-' or event == 'h':: 在事件循环中，我们检查 event 变量。如果它是按钮的 key 值 (-HELLO-)，说明按钮被点击了；如果它是字符串 'h'，说明键盘上的 'h' 键被按下了。在这两种情况下，我们都执行相同的操作，即打印“Hello, World!”。
注意事项与最佳实践
- 事件名称的识别： 大多数标准字母和数字键会以其小写形式返回（如 'a', '1'）。特殊键（如 'Escape', 'Shift_L', 'Control_R'）会返回特定的字符串。你可以通过打印 event 来查看具体按键对应的事件字符串。
- 区分大小写： 键盘事件通常返回小写字母。如果你需要区分大小写，可能需要结合 values 中的修饰键信息（如 Shift 键）。
- 冲突处理： 如果你的应用程序有多个键盘快捷键，或者某个键同时被用于输入框和快捷键，你需要仔细设计事件处理逻辑，避免冲突。例如，当焦点在一个输入框中时，你可能不希望键盘快捷键被触发。
- bind_return_key 的作用： PySimpleGUI 按钮还有一个 bind_return_key=True 参数。这个参数的作用是当按钮获得焦点时，按下回车键（Enter）会触发该按钮的事件。这与 return_keyboard_events=True 捕获任意键盘事件是不同的机制。本教程主要关注后者，以实现任意按键绑定。
- 用户体验与可访问性： 提供键盘快捷键可以显著提高应用程序的可用性和可访问性，特别是对于习惯使用键盘的用户或有特殊需求的用户。
总结
通过在 sg.Window 中设置 return_keyboard_events=True，并结合事件循环中的条件判断，PySimpleGUI 开发者可以轻松地将任意键盘按键绑定到特定的 GUI 按钮事件，从而创建出响应更迅速、交互性更强的应用程序。这种方法极大地扩展了 PySimpleGUI 应用的控制方式，为用户提供了更加灵活的操作体验。
