GTK截图方法：遍历窗口并保存为PNG

本篇文章给大家分享《在 GTK 中，可以通过遍历所有顶级窗口（Gtk.Window）并使用 Gdk.Pixbuf 截圖。以下是一个 Python 示例：import gi gi.require_version('Gtk', '3.0') from gi.repository import Gtk, Gdk def take_screenshot(window): # 获取窗口的截图 pixbuf = window.get_window().get_snapshot(Gdk.Snapshot()) if pixbuf: pixbuf.savev("screenshot.png", "png", [], []) def on_window_destroy(widget): Gtk.main_quit() # 遍历所有已打开的窗口 for window in Gtk.Window.list_toplevels(): print(f"Found window: {window}") take_screenshot(window) window.connect("destroy", on_window_destroy) Gtk.main()注意事项：该方法适用于 Gtk.Window 的子类。若需截图整个屏幕，可使用 Gdk.Screen.get_default().get_root_window()。确保已正确初始化 GTK 环境。此代码可用于自动化测试或调试工具中。》，覆盖了文章的常见基础知识，其实一个语言的全部知识点一篇文章是不可能说完的，但希望通过这些问题，让读者对自己的掌握程度有一定的认识(B 数)，从而弥补自己的不足，更好的掌握它。

在 Python 2.7 + GTK 2 环境下（如 Gwyddion 插件开发），若需批量处理由分析工具弹出的 `Gtk.Window` 实例（例如截图、关闭等），可借助 GDK 的 `list_toplevels()` 获取顶层窗口列表，并结合 `Wnck` 库实现更可靠的窗口枚举与状态管理。

GTK 的 Gtk.Window 实例默认属于顶层窗口（toplevel window），因此最直接的方式是调用 gtk.gdk.get_default_root_window().get_screen().get_toplevel_windows() 或更推荐的 gtk.gdk.screen_get_default().get_toplevel_windows() —— 但注意：GTK 2 中实际应使用 gtk.gdk.screen_get_default().get_toplevel_windows() 的替代方案 gtk.gdk.screen_get_default().get_window_manager_name() 并不提供枚举能力；真正可用的是 gtk.gdk.screen_get_default().get_root_window().get_children()，但这不可靠。

✅ 正确且稳定的做法是使用 Wnck（Window Navigator Construction Kit）—— 它专为桌面环境窗口管理设计，能跨 GTK 版本可靠获取所有已映射（visible）、非最小化的顶层窗口，且天然支持窗口标题、类型、状态等元信息，非常适合自动化截图场景。

✅ 推荐方案：使用 Wnck 枚举并操作 GTK 窗口

首先确保系统已安装 python-wnck（Ubuntu/Debian）或对应 Python 2.7 兼容包：

sudo apt-get install python-wnck  # Ubuntu/Debian
# 或通过源码编译适配 Python 2.7 的 pywnck

然后在代码中使用：

import gtk
import wnck
import time

# 初始化 Wnck（必须在 gtk.main() 之前或模拟主循环上下文中调用）
screen = wnck.screen_get_default()
screen.force_update()  # 同步窗口状态

# 获取所有已映射（显示中）的窗口
windows = [w for w in screen.get_windows() if w.is_mapped() and not w.is_minimized()]

# 按窗口创建时间排序（近似 Z-order，较新窗口通常在后）
# 注意：Wnck 不保证严格顺序，但 get_windows() 返回顺序通常与窗口栈一致
windows.sort(key=lambda w: w.get_xid())  # 可选：按 X11 ID 稳定排序

print "Found %d visible windows" % len(windows)
for i, win in enumerate(windows):
    title = win.get_name().strip() or "Untitled"
    print "Window %d: '%s' (XID: 0x%x)" % (i+1, title, win.get_xid())

    # 示例：截图（需配合 gtk.gdk.Pixbuf 或外部工具如 scrot）
    # 这里仅示意，真实截图建议用：
    #   - gdk.Window.grab() + pixbuf.get_from_drawable()（GTK 2）
    #   - 或调用系统命令：os.system("scrot -u /tmp/screenshot_%d.png" % i)

    # 示例：安全关闭（避免引用失效）
    win.close(time.time())

⚠️ 关于 list_toplevels() 与引用计数的说明

你提到的 gtk.gdk.screen_get_default().get_toplevel_windows() 在 GTK 2 中并不存在（它是 GTK 3+ 的 API）。你在文档中看到的 g_list_foreach(..., (GFunc)g_object_ref, NULL) 属于底层 C API，Python 绑定中无需手动处理引用计数：PyGTK 自动管理 GObject 生命周期。所谓 g_object_ref 是为防止回调中窗口被意外销毁而做的“加引用”，unref 则是释放——Python 层完全透明，你只需确保不提前 del win 或显式调用 win.destroy() 即可安全遍历。

? 窗口顺序说明：wnck.Screen.get_windows() 返回列表顺序大致反映窗口栈（Z-order），最新激活/创建的窗口通常靠后。如需严格按弹出顺序命名截图，建议在工具创建窗口时主动将其追加到全局列表（如 all_result_windows.append(my_window)），这是最可靠的方式。

✅ 补充：强制 GTK 窗口立即绘制（解决白屏截图问题）

若仍希望“边运行边截图”，可在每次弹窗后插入 GTK 事件处理：

my_window.show_all()
while gtk.events_pending():  # 强制处理所有待决绘图事件
    gtk.main_iteration_do(False)
time.sleep(0.1)  # 短暂等待渲染完成（实测 50–100ms 通常足够）

此方法绕过 gtk.main() 缺失的问题，利用 main_iteration_do(False) 主动驱动 GTK 消息循环一次，确保窗口布局、绘制完成后再截图。

✅ 总结

• ✅ 首选 Wnck：稳定、跨 GTK 版本、提供窗口元数据，适合 Gwyddion 等嵌入式 GTK 场景；
• ❌ 避免依赖 list_toplevels()（GTK 2 不支持）或手动引用计数（PyGTK 已封装）；
• ✅ 截图前务必调用 events_pending() + main_iteration_do() 强制刷新，或改用“全量弹窗 → Wnck 枚举 → 批量截图”策略；
• ✅ 命名截图时，优先使用 win.get_name()（需确保你的子类正确设置 set_title()），辅以索引防重名。

该方案完全兼容 Python 2.7 和 Gwyddion 的 GTK 2 运行环境，无需修改原有工具代码，即可实现鲁棒的窗口批量截图自动化。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。