在 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() 全屏捕获并裁剪坐标区域。
综上，不依赖 wnck 等外部库，仅用 PyGTK 原生接口即可稳健解决多窗口批量截图问题，兼顾 Gwyddion 的受限运行环境与 Python 2.7 兼容性要求。
