GTK4中如何让持有CustomWidget的组件监听其内部私有按钮的clicked信号？

刚好之前做项目碰到过几乎一样的问题，GTK4的信号不传播、组件私有还不能继承的限制确实有点头疼，给你几个亲测好用的解决思路：

1. 在CustomWidget内部自定义转发信号 #

因为CustomWidget是final类没法通过继承扩展，那咱们就在它内部自己定义新的信号，把私有按钮的clicked信号直接转发出去就好。

比如给CustomWidget分别定义三个自定义信号：button-one-clicked、button-two-clicked、button-three-clicked，然后在CustomWidget的初始化逻辑里，把每个私有按钮的clicked信号连接到对应自定义信号的发射函数上。这样外部持有CustomWidget的组件，直接连接这些自定义信号就能拿到按钮点击的通知了。

举个C语言的实现示例：

// 在CustomWidget的类初始化方法中注册自定义信号
static void custom_widget_class_init(CustomWidgetClass *klass) {
  // 注册第一个按钮的转发信号
  g_signal_new("button-one-clicked",
               G_TYPE_FROM_CLASS(klass),
               G_SIGNAL_RUN_LAST,
               0, NULL, NULL,
               g_cclosure_marshal_VOID__VOID,
               G_TYPE_NONE, 0);
  // 同理注册另外两个按钮的转发信号
}

// 在CustomWidget的实例初始化方法中连接按钮信号与转发逻辑
static void custom_widget_init(CustomWidget *self) {
  // 假设self->button1是内部的私有按钮指针
  g_signal_connect(self->button1, "clicked", G_CALLBACK(emit_button_one_clicked), self);
  // 另外两个按钮做同样的连接操作
}

// 负责发射自定义信号的回调函数
static void emit_button_one_clicked(CustomWidget *self) {
  g_signal_emit(self, g_signal_lookup("button-one-clicked", CUSTOM_TYPE_WIDGET), 0);
}

外部使用的时候就很简单了，直接连接CustomWidget的自定义信号：

g_signal_connect(my_custom_widget, "button-one-clicked", G_CALLBACK(on_button_one_clicked), user_data);

2. 用GAction绑定按钮点击（更符合GTK4现代设计） #

另一种更贴合GTK4设计风格的方式是使用GAction。在CustomWidget内部给每个私有按钮创建对应的GAction，把按钮的clicked信号绑定到Action的激活操作上，再把这些Action添加到CustomWidget的动作映射（Action Map）中。

外部组件可以通过CustomWidget的动作映射获取到这些Action，然后直接连接它们的activate信号来监听点击事件。

示例代码片段：

// 在CustomWidget初始化时创建并绑定Action
static void custom_widget_init(CustomWidget *self) {
  // 为第一个按钮创建Action
  GAction *button1_action = g_simple_action_new("button1", NULL);
  // 将Action添加到CustomWidget的动作映射中
  g_action_map_add_action(G_ACTION_MAP(self), button1_action);
  // 把按钮的clicked信号绑定到Action的激活操作
  g_signal_connect_swapped(self->button1, "clicked", G_CALLBACK(g_action_activate), button1_action);
  
  // 另外两个按钮重复类似的操作
}

外部监听的代码可以这么写：

// 从CustomWidget的动作映射中获取目标Action
GAction *button1_action = g_action_map_lookup_action(G_ACTION_MAP(my_custom_widget), "button1");
// 连接Action的activate信号
g_signal_connect(button1_action, "activate", G_CALLBACK(on_button1_action_activated), user_data);

3. 利用EventController做事件转发 #

你提到EventControllers的说明太简单，其实它也能解决这个问题。我们可以给CustomWidget添加一个EventControllerClick，然后在事件处理函数里识别点击的目标是不是内部的私有按钮，如果是，就触发对应的通知逻辑（比如还是用自定义信号发射，或者直接调用外部注册的回调）。

示例代码：

// 点击事件的处理回调
static gboolean on_click_pressed(GtkEventControllerClick *controller, gdouble x, gdouble y, CustomWidget *self) {
  // 获取点击事件的目标组件
  GtkWidget *target = gtk_event_controller_get_event_target(GTK_EVENT_CONTROLLER(controller));
  
  // 判断点击的是哪个私有按钮
  if (target == self->button1) {
    g_signal_emit(self, g_signal_lookup("button-one-clicked", CUSTOM_TYPE_WIDGET), 0);
  } else if (target == self->button2) {
    g_signal_emit(self, g_signal_lookup("button-two-clicked", CUSTOM_TYPE_WIDGET), 0);
  } else if (target == self->button3) {
    g_signal_emit(self, g_signal_lookup("button-three-clicked", CUSTOM_TYPE_WIDGET), 0);
  }
  
  return GDK_EVENT_PROPAGATE; // 允许事件继续传播
}

// 在CustomWidget初始化时添加事件控制器
static void custom_widget_init(CustomWidget *self) {
  GtkEventController *click_controller = gtk_event_controller_click_new();
  g_signal_connect(click_controller, "pressed", G_CALLBACK(on_click_pressed), self);
  gtk_widget_add_controller(GTK_WIDGET(self), click_controller);
}

这种方法适合不想定义太多信号的场景，但要注意事件的传播顺序，确保能正确识别目标组件。

上面这几种方法里，自定义转发信号是最直接易懂的，GAction的方式则更符合GTK4的现代设计理念，你可以根据自己的项目需求来选择。

内容来源于stack exchange