如何遍历当前所有打开的 Gtk.Window 实例

霞舞 2026-01-03 00:00:00 次阅读

在 python 2.7 + gtk 环境下（如 gwyddion 插件开发），若需对所有已创建但尚未显示完全的 `gtk.window` 子类实例批量截图，可借助 gtk 自身的 `gtk.window.list_toplevels()` 方法获取窗口列表，并配合 `gdk.window.draw_to_image()` 实现可靠截图。

GTK 提供了原生、轻量且无需额外依赖的机制来枚举所有顶层窗口：Gtk.Window.list_toplevels()。该方法返回一个 list，包含当前进程中所有已创建（show() 已调用）的 Gtk.Window 及其子类实例——这正是你在 Gwyddion 中动态弹出的结果窗口所需的目标集合。

import gtk
import gdk

def capture_all_windows(prefix="screenshot"):
    """对所有已显示的 Gtk.Window 实例截图并保存"""
    windows = gtk.Window.list_toplevels()

    # 注意：list_toplevels() 返回顺序与窗口创建/显示顺序基本一致（LIFO 栈式，后创建者靠前）
    # 若需按创建时间排序，建议在窗口实例化时打上时间戳并自行管理
    for i, win in enumerate(windows):
        # 确保窗口已映射（即真正可见），避免白屏
        if not win.get_mapped():
            win.show_now()  # 强制立即映射，触发绘制
            while gtk.events_pending():
                gtk.main_iteration()

        # 获取底层 Gdk.Window 并截图
        gdk_win = win.get_window()
        if gdk_win is None:
            continue

        x, y, width, height = gdk_win.get_geometry()
        try:
            # 截取整个窗口客户区（不含边框）
            pixbuf = gdk.pixbuf_get_from_drawable(
                None, gdk_win, gdk.colormap_get_system(),
                0, 0, 0, 0, width, height
            )
            filename = "%s_%03d.png" % (prefix, i + 1)
            pixbuf.save(filename, "png")
            print("Saved: %s" % filename)
        except Exception as e:
            print("Failed to capture %s: %s" % (win.get_title() or "unnamed", str(e)))

# 调用示例（在你的分析循环结束后执行）
# capture_all_windows("afm_channel_2")

⚠️ 关键注意事项：

list_toplevels() 返回的是 Python 对象引用，不是 C 层指针，因此无需手动 g_object_ref/unref —— 这是 C API 文档中针对原生 GObject 内存管理的说明，在 PyGTK（Python 2.7 绑定）中由 Python 垃圾回收自动处理；
窗口“未绘制”问题本质是 GTK 的事件循环未及时刷新：Gwyddion 不调用 gtk.main() 是因其自身主循环接管了 GTK 事件调度，但你仍可通过 gtk.events_pending() + gtk.main_iteration() 主动泵送事件，确保窗口完成映射与首次绘制；
list_toplevels() 的遍历顺序为 最近创建/显示的窗口排在前面（内部使用链表头插法），因此索引 i 大致反映窗口弹出时序；如需严格顺序，请在创建每个窗口时将其追加到全局 list 并记录时间戳；
若截图仍为空白，请检查窗口是否设置了 set_app_paintable(False) 或启用了透明背景，此时应改用 gtk.gdk.get_default_root_window() 全屏捕获并裁剪坐标区域。