PySimpleGUI 如何设置事件的监听器

在 PySimpleGUI 中，事件的监听主要通过 window.read() 方法结合事件循环实现。以下是详细说明和示例：

---

1. 基本事件监听流程

PySimpleGUI 的事件监听基于 事件驱动模型，核心步骤如下：

1. 创建窗口和控件，为需要监听的控件设置 key 和 enable_events=True（如输入框、按钮等）。
2. 进入事件循环，通过 window.read() 获取事件和控件值。
3. 判断事件类型（如按钮点击、输入框变化等），执行对应逻辑。
4. 关闭窗口（如用户点击关闭按钮）。

示例代码

import PySimpleGUI as sg

# 1. 定义布局（设置 key 和 enable_events）
layout = [
    [sg.Input(key='-INPUT-', enable_events=True)],  # 监听输入变化
    [sg.Button('提交', key='-SUBMIT-')],           # 按钮点击默认触发事件
    [sg.Text('', key='-OUTPUT-')]                  # 显示结果
]

# 2. 创建窗口
window = sg.Window('事件监听示例', layout)

# 3. 事件循环
while True:
    event, values = window.read()  # 阻塞，等待用户操作

    # 4. 判断事件类型
    if event == sg.WIN_CLOSED:     # 关闭窗口事件
        break
    elif event == '-INPUT-':       # 输入框内容变化
        window['-OUTPUT-'].update(f"输入内容: {values['-INPUT-']}")
    elif event == '-SUBMIT-':      # 按钮点击
        window['-OUTPUT-'].update(f"提交内容: {values['-INPUT-']}")

# 5. 关闭窗口
window.close()

---

2. 不同控件的事件监听

(1) 按钮（Button）

• 默认行为：按钮点击会自动触发事件，无需 enable_events=True。
• 示例：

  if event == '-BUTTON_KEY-':
      print("按钮被点击！")
  

(2) 输入框（Input）

• 需设置 enable_events=True 才能监听输入变化。
• 示例：

  layout = [sg.Input(key='-INPUT-', enable_events=True)]
  if event == '-INPUT-':
      print(f"输入内容: {values['-INPUT-']}")
  

(3) 下拉菜单（Combo）

• 监听选项变化：

  layout = [sg.Combo(['A', 'B', 'C'], key='-COMBO-', enable_events=True)]
  if event == '-COMBO-':
      print(f"选择: {values['-COMBO-']}")
  

(4) 复选框（Checkbox）

• 监听勾选状态变化：

  layout = [sg.Checkbox('同意', key='-CHECK-', enable_events=True)]
  if event == '-CHECK-':
      print(f"勾选状态: {values['-CHECK-']}")
  

(5) 列表框（Listbox）

• 监听选中项变化：

  layout = [sg.Listbox(['1', '2', '3'], key='-LIST-', enable_events=True)]
  if event == '-LIST-':
      print(f"选中: {values['-LIST-']}")
  

---

3. 高级事件监听技巧

(1) 超时监听

window.read(timeout=1000) 可设置超时（毫秒），超时后返回 timeout 事件：

event, values = window.read(timeout=1000)
if event == 'timeout':
    print("1秒内无操作")

(2) 绑定快捷键

通过 bind_return_key=True 让输入框按回车键触发事件：

sg.Input(key='-INPUT-', enable_events=True, bind_return_key=True)

(3) 自定义事件

通过 window.write_event_value() 手动触发事件：

window.write_event_value('-CUSTOM-', '自定义数据')  # 触发自定义事件
if event == '-CUSTOM-':
    print(f"收到自定义事件: {values[event]}")

---

4. 完整示例：多控件监听

import PySimpleGUI as sg

layout = [
    [sg.Text("输入框监听："), sg.Input(key='-INPUT-', enable_events=True)],
    [sg.Text("下拉菜单："), sg.Combo(['A', 'B', 'C'], key='-COMBO-', enable_events=True)],
    [sg.Button('提交'), sg.Button('退出')],
    [sg.Multiline(key='-LOG-', size=(40, 10))]
]

window = sg.Window("多控件监听", layout)

while True:
    event, values = window.read()

    if event in (sg.WIN_CLOSED, '退出'):
        break
    elif event == '-INPUT-':
        window['-LOG-'].print(f"输入: {values['-INPUT-']}")
    elif event == '-COMBO-':
        window['-LOG-'].print(f"选择: {values['-COMBO-']}")
    elif event == '提交':
        window['-LOG-'].print(f"提交内容: {values['-INPUT-']}")

window.close()

---

5. 总结

功能	方法
基本监听	event, values = window.read() + if event == 'key'
控件事件	设置 enable_events=True（如输入框、下拉菜单）
按钮监听	默认支持，无需额外设置
超时监听	window.read(timeout=ms)
自定义事件	window.write_event_value('-KEY-', data)

通过合理使用这些方法，可以灵活实现 PySimpleGUI 的事件监听逻辑。