如何从PyGObject获取GObject.Callback用于Gtk.Builder？

我完全理解你不想依赖Gtk.Builder.connect_signals()、只想用add_callback_symbol()来注册回调的需求——这种精细控制在很多场景下都很实用，我之前也踩过类似的坑。

你遇到的核心问题在于：PyGObject里根本不需要手动用GObject.Callback()包装函数（这个类是给内部机制用的，直接实例化必然会抛出NotImplementedError），也没有对应C语言里的G_CALLBACK宏。正确的做法其实很简单，只要注意两个关键细节：

1. 先添加回调符号，再加载UI文件 #

这是最容易忽略的点：Gtk.Builder在解析UI文件时会立刻查找信号对应的回调符号，如果先加载UI再添加符号，Builder已经完成了解析，自然找不到你的函数。

正确的流程是：

• 创建Builder实例
• 用add_callback_symbol()注册所有需要的回调
• 再调用add_from_file()/add_from_string()加载UI

2. 确保函数签名完全匹配 #

你的Python函数必须和UI文件中信号定义的参数完全对应：

• 第一个参数永远是触发信号的控件（比如按钮、窗口）
• 如果UI里指定了object或user_data，函数需要接收对应的第二个参数
• 如果信号要求返回值（比如GtkFileChooser的confirm-overwrite信号），必须返回正确类型的值（比如布尔值）

完整可运行示例 #

假设你有如下UI文件（命名为test.ui）：

<?xml version="1.0" encoding="UTF-8"?>
<interface>
  <object class="GtkWindow" id="main_win">
    <property name="visible">True</property>
    <property name="title">Callback Test</property>
    <child>
      <object class="GtkButton" id="click_btn">
        <property name="visible">True</property>
        <property name="label">Click Me!</property>
        <signal name="clicked" handler="on_btn_clicked"/>
      </object>
    </child>
  </object>
</interface>

对应的Python代码：

import gi
gi.require_version('Gtk', '3.0')
from gi.repository import Gtk

def on_btn_clicked(button):
    print("Button clicked!")
    button.set_label("Done!")

def main():
    builder = Gtk.Builder()
    # 先注册回调符号
    builder.add_callback_symbol("on_btn_clicked", on_btn_clicked)
    # 再加载UI文件
    builder.add_from_file("test.ui")
    
    window = builder.get_object("main_win")
    window.connect("destroy", Gtk.main_quit)
    window.show_all()
    Gtk.main()

if __name__ == "__main__":
    main()

运行这段代码，点击按钮就能正常触发回调，全程不需要调用connect_signals()。

额外注意事项 #

• 如果你的回调是类的方法，直接传递绑定方法即可（比如self.on_btn_clicked），不需要额外包装
• 如果需要动态添加回调（加载UI之后），你可能需要调用builder.connect_signals()并传入包含新回调的字典，但这已经接近你不想用的方式了——如果只是初始注册，前面的方法完全够用

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