GTK4中如何绑定按键触发指定动作（按q键关闭窗口）

GTK4 已经删除了GTK3时代窗口、应用对象上直接挂载的key-pressed信号，所有键盘、鼠标这类输入事件，必须通过独立的*事件控制器（EventController）*对象处理。你两个方案报错都是因为给不存在对应信号的对象绑定了信号，另外让窗口类多继承Gtk.EventControllerKey的写法是错误的：事件控制器是独立的功能组件，不是用来给窗口类继承的父类，需要创建实例后挂载到窗口上才能生效。

核心逻辑是给窗口挂载Gtk.EventControllerKey控制器，监听控制器的key-pressed信号，在回调里判断按键是否为q，符合条件就关闭窗口，完整可运行代码：

import gi
gi.require_version("Gtk", "4.0")
from gi.repository import Gtk, Gdk

def on_activate(app):
    win = Gtk.ApplicationWindow(application=app)
    
    # 初始化键盘事件控制器
    key_ctrl = Gtk.EventControllerKey.new()
    # 绑定按键按下回调
    def key_press_handle(ctrl, keyval, keycode, state):
        # 匹配q/Q键，需要区分大小写就只留Gdk.KEY_q
        if keyval in (Gdk.KEY_q, Gdk.KEY_Q):
            win.close()
            return True
        return False
    key_ctrl.connect("key-pressed", key_press_handle)
    # 将控制器挂载到窗口，即可接收窗口范围内的所有键盘事件
    win.add_controller(key_ctrl)

    btn = Gtk.Button(label="Hello, World!")
    btn.connect("clicked", lambda _: win.close())
    win.set_child(btn)
    win.present()

app = Gtk.Application(application_id="org.gtk.Example")
app.connect("activate", on_activate)
app.run(None)

• 按键值判断用Gdk模块预定义的KEY_*常量，不要硬写ASCII码，避免不同平台、不同输入法场景下的兼容问题
• 回调里处理完按键逻辑返回True是告诉GTK这个事件已经被消费，不会再继续传递给窗口内的子控件（比如按钮），避免触发意外行为
• 不光是键盘事件，GTK4里的鼠标点击、滑动、手势等所有输入事件，都要通过对应类型的事件控制器处理，没有直接挂在窗口上的输入信号了

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