4. GTK基础入门

在嵌入式Linux上开发图形界面，GTK并不是一组“画控件的函数集合”，而是一套建立在GObject之上的面向对象框架。理解GObject对象模型、信号机制和主循环，是后续所有窗口、控件、事件处理代码能够写对、写稳的前提。本章从这三个基础机制出发，再落到窗口与控件的基本使用方式。

一、GObject对象模型：C语言里的“类”

GTK用C语言实现，但它的API风格是面向对象的。每个控件（如GtkButton、GtkLabel）都是一个GObject实例，拥有类型、引用计数、属性系统和父子继承关系。GObject通过GType在运行时注册类型，形成一条从GObject到GtkWidget再到具体控件的继承链。

对象模型带来三个直接好处：

• 类型安全：通过G_TYPE_CHECK_INSTANCE_CAST等宏在运行时校验类型，避免误用。
• 引用计数：g_object_ref()与g_object_unref()管理生命周期，容器接管子控件后由容器负责释放。
• 属性系统：通过g_object_set()/g_object_get()统一读写属性，如"label"、"sensitive"。

在嵌入式场景中，对象模型还意味着内存可控：控件被销毁时，其子对象、信号连接、属性内存都会按规则释放，减少长期运行中的泄漏风险。

二、信号机制：控件如何“通知”你的代码

GTK不使用回调注册表，而是使用信号（signal）。当用户点击按钮、窗口关闭、输入框内容变化时，控件会发射对应信号，已连接的处理函数被依次调用。连接信号的核心API是g_signal_connect()。

GtkWidget *button = gtk_button_new_with_label("确定");
g_signal_connect(button, "clicked",
                 G_CALLBACK(on_button_clicked), NULL);

static void on_button_clicked(GtkButton *btn, gpointer user_data)
{
    g_print("按钮被点击\n");
}

信号处理函数必须与信号签名匹配："clicked"的第一个参数是发射者对象，第二个是用户数据。常见信号包括"clicked"、"destroy"、"changed"、"activate"。若只需触发一次，可用g_signal_connect_swapped()或g_signal_connect_object()简化参数传递。

三、主循环：事件驱动的发动机

GTK程序不会在main()里写while(1)轮询，而是把控制权交给gtk_main()。主循环持续从事件源（X11/Wayland、输入设备、定时器、文件描述符）收集事件，分发给对应控件，再触发信号处理函数。没有主循环，窗口不会刷新，信号也不会被处理。

典型启动流程如下：

1. gtk_init(&argc, &argv)：初始化GTK，解析显示相关参数。
2. 创建窗口与控件，设置属性并加入容器。
3. gtk_widget_show_all(window)：递归显示窗口及子控件。
4. gtk_main()：进入主循环，开始事件分发。
5. 窗口关闭或调用gtk_main_quit()后退出循环。

主循环内部由GLib的GMainLoop驱动，GTK只是在其上注册了图形事件源。因此定时器g_timeout_add()、空闲任务g_idle_add()与界面刷新共享同一事件队列，这也是嵌入式UI中做周期性状态更新的常用手段。

四、窗口与控件的基本使用

GTK窗口是GtkWindow，控件是GtkWidget的子类。控件必须被加入容器才能显示，容器负责布局。最常用的容器是GtkBox（线性排列）和GtkGrid（网格排列）。

GtkWidget *window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
gtk_window_set_title(GTK_WINDOW(window), "嵌入式控制面板");
gtk_window_set_default_size(GTK_WINDOW(window), 480, 320);

GtkWidget *box = gtk_box_new(GTK_ORIENTATION_VERTICAL, 8);
GtkWidget *label = gtk_label_new("系统状态：正常");
GtkWidget *button = gtk_button_new_with_label("刷新");

gtk_box_pack_start(GTK_BOX(box), label, FALSE, FALSE, 0);
gtk_box_pack_start(GTK_BOX(box), button, FALSE, FALSE, 0);
gtk_container_add(GTK_CONTAINER(window), box);

g_signal_connect(window, "destroy",
                 G_CALLBACK(gtk_main_quit), NULL);
gtk_widget_show_all(window);
gtk_main();

这段代码体现了GTK的基本套路：创建对象、设置属性、加入容器、连接信号、显示、进入主循环。嵌入式项目中，窗口尺寸通常按屏幕分辨率固定，控件间距和字体需考虑触摸操作的可点击面积。

五、常见误区与复盘