如何在Ubuntu下通过信号机制接收GTK3 C桌面应用的键盘布局变更事件？

GTK3本身没有提供直接的键盘布局变更信号，但可以通过底层窗口系统的事件机制实现无轮询的监听，以下分X11和Wayland两种环境给出具体实现：

X11环境下的实现 #

基于X11的XkbStateNotify事件，通过GTK的事件过滤器捕获布局变更：

代码示例 #

#include <gtk/gtk.h>
#include <gdk/gdkx.h>
#include <X11/XKBlib.h>

// 事件过滤器：处理Xkb状态变更事件
GdkFilterReturn keyboard_layout_filter(GdkXEvent *xevent, GdkEvent *event, gpointer data) {
    XEvent *xev = (XEvent *)xevent;
    if (xev->type == XkbEvent && xev->xkb.any.xkb_type == XkbStateNotify) {
        static int last_group = -1;
        // 获取当前布局组ID
        int current_group = XkbGroupForCoreState(xev->xkb.state.state);
        
        if (current_group != last_group) {
            g_print("键盘布局已变更，当前组ID：%d\n", current_group);
            // 此处可调用自定义业务逻辑或触发自定义信号
            last_group = current_group;
        }
    }
    return GDK_FILTER_CONTINUE;
}

int main(int argc, char *argv[]) {
    gtk_init(&argc, &argv);

    GdkDisplay *display = gdk_display_get_default();
    Display *xdisplay = gdk_x11_display_get_xdisplay(display);

    // 注册XkbStateNotify事件
    XkbSelectEvents(xdisplay, XkbUseCoreKbd, XkbStateNotifyMask, XkbStateNotifyMask);

    // 向GTK主循环添加事件过滤器
    gdk_display_add_filter(display, keyboard_layout_filter, NULL);

    // 初始化GTK窗口（示例）
    GtkWidget *window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
    g_signal_connect(window, "destroy", G_CALLBACK(gtk_main_quit), NULL);
    gtk_widget_show_all(window);

    gtk_main();
    return 0;
}

编译说明 #

编译时需链接X11和XKB相关库：

gcc -o layout-monitor layout-monitor.c `pkg-config --cflags --libs gtk+-3.0 x11 xkbfile`

扩展说明 #

• 若需要获取布局名称而非组ID，可使用XkbGetNames()接口查询具体布局信息
• XkbGroupForCoreState返回的组ID对应不同的键盘布局，可提前通过系统配置映射布局名称

Wayland环境下的实现 #

Wayland没有统一的布局变更事件标准，需依赖桌面环境提供的D-Bus信号，以GNOME桌面为例：

代码示例 #

#include <gtk/gtk.h>
#include <gio/gio.h>

// D-Bus信号回调：处理GNOME桌面的布局变更
static void on_gnome_layout_changed(GDBusConnection *connection, 
                                    const gchar *sender_name, 
                                    const gchar *object_path, 
                                    const gchar *interface_name, 
                                    const gchar *signal_name, 
                                    GVariant *parameters, 
                                    gpointer user_data) {
    g_print("键盘布局已变更（Wayland GNOME）\n");
    // 可解析parameters获取布局详细信息，示例：
    // gchar *layout_name;
    // g_variant_get(parameters, "(s)", &layout_name);
    // g_print("当前布局：%s\n", layout_name);
    // g_free(layout_name);
}

int main(int argc, char *argv[]) {
    gtk_init(&argc, &argv);

    // 获取会话总线连接
    GDBusConnection *bus = g_bus_get_sync(G_BUS_TYPE_SESSION, NULL, NULL);
    // 订阅GNOME Shell的布局变更信号
    g_dbus_connection_signal_subscribe(bus,
                                       "org.gnome.Shell",
                                       "org.gnome.Shell",
                                       "KeyboardLayoutChanged",
                                       "/org/gnome/Shell",
                                       NULL,
                                       G_DBUS_SIGNAL_FLAGS_NONE,
                                       on_gnome_layout_changed,
                                       NULL,
                                       NULL);

    // 初始化GTK窗口（示例）
    GtkWidget *window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
    g_signal_connect(window, "destroy", G_CALLBACK(gtk_main_quit), NULL);
    gtk_widget_show_all(window);

    gtk_main();
    return 0;
}

注意事项 #

• 不同Wayland桌面的D-Bus接口不同，例如KDE可能使用org.kde.KeyboardLayouts接口
• 需确保应用有权限访问对应D-Bus接口

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