
在 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")⚠️ 关键注意事项:
这本书并不是一本语言参考书,但它是一个Android开发者去学习Kotlin并且使用在自己项目中的一个工具。我会通过使用一些语言特性和有趣的工具和库来解决很多我们在日常生活当中都会遇到的典型问题。 这本书是非常具有实践性的,所以我建议你在电脑面前跟着我的例子和代码实践。无论何时你都可以在有一些想法的时候深入到实践中去。 这本书适合你吗? 写这本书是为了帮助那些有兴趣 使用Kotlin语言来进行开发的Android开发者。 如果你符合下面这些情况,那这本书是适合你的: 你有相关Android开发和Andro
- 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() 全屏捕获并裁剪坐标区域。
综上,不依赖 wnck 等外部库,仅用 PyGTK 原生接口即可稳健解决多窗口批量截图问题,兼顾 Gwyddion 的受限运行环境与 Python 2.7 兼容性要求。









