如何在GTK中监听按键？使用GtkEventControllerKey遇编译错误

我在GTK3程序中尝试捕获按键输入，参考相关内容将GtkEventKey替换为推荐的GtkEventControllerKey后，编写了如下代码：

void on_window_main_key_press_event(GtkWidget *widget, GtkEventControllerKey *key, gpointer user_data) {
    guint TheKeyThatWasPressed = key->keyval;
}

编译时出现错误：

error: invalid use of incomplete typedef ‘GtkEventControllerKey’ {aka ‘struct _GtkEventControllerKey’}
  147 |     guint TheKeyThatWasPressed = key->keyval;

错误原因与修复方案 #

• GtkEventControllerKey是不透明结构体：GTK3中这类结构体不允许直接访问内部成员，必须使用官方提供的API函数获取数据。
• 回调函数参数签名错误：GtkEventControllerKey的key-pressed信号回调参数并非上述格式，正确的签名包含按键值、键码和修饰符状态。

正确的代码示例：

void on_window_main_key_press_event(GtkEventControllerKey *controller, guint keyval, guint keycode, GdkModifierType state, gpointer user_data) {
    // 直接使用传入的keyval即可
    guint TheKeyThatWasPressed = keyval;
    // 示例：处理ESC按键逻辑
    if (TheKeyThatWasPressed == GDK_KEY_Escape) {
        // 编写你的处理代码
    }
}

如果需要从GtkEventControllerKey实例中获取其他信息，可使用对应的API函数，例如：

// 获取当前聚焦的组件
GtkWidget* focused_widget = gtk_event_controller_key_get_focus_widget(controller);

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