在 python 2.7 + gtk 2 环境（如 gwyddion 插件）中，无法依赖 `gtk.main()` 时，可通过 `gtk.window_list_toplevels()` 获取所有顶层窗口并安全遍历，配合 `window.get_title()` 区分顺序，再执行截图与清理。
在 Gwyddion 这类基于 GTK 2 的科学分析工具中，插件通常不调用 gtk.main() —— 因为 Gwyddion 自身已接管主事件循环，直接调用 gtk.main() 反而会导致阻塞或崩溃。此时，你创建的每个结果窗口（即使经过多层继承）只要未被显式销毁且已 show()，就属于 GTK 的顶层窗口（toplevel window），可通过 GTK 提供的底层接口统一获取。
✅ 正确方法：使用 gtk.window_list_toplevels()
GTK 2（PyGTK）提供了可靠的 C 绑定函数 gtk.window_list_toplevels()，它返回一个 list，包含当前所有已映射（mapped）、可见的 gtk.Window 及其子类实例（包括你的自定义结果窗口）。这是最直接、无需外部依赖的解决方案：
import gtk
# 假设你已完成所有分析，所有结果窗口均已 show()
windows = gtk.window_list_toplevels()
# 按创建顺序近似排序（GTK 通常按添加顺序返回，但不严格保证）
# 更可靠的方式：按窗口标题或用户数据标识排序
windows.sort(key=lambda w: w.get_title() if w.get_title() else "unnamed")
for i, win in enumerate(windows):
# 确保窗口已完全绘制（关键！）
while gtk.events_pending():
gtk.main_iteration()
# 示例：截图逻辑（需自行实现，如用 gdk.Pixbuf or external tool）
# screenshot = gtk.gdk.Pixbuf.get_from_drawable(
# win.get_window(), win.get_colormap(), 0, 0, 0, 0, win.allocation.width, win.allocation.height)
# screenshot.save("result_%02d_%s.png" % (i+1, win.get_title().replace("/", "_")), "png")
print("Processing window %d: '%s'" % (i+1, win.get_title()))
# ... 执行截图、保存、关闭等操作
# win.destroy() # 或 win.hide()，视需求而定⚠️ 关于 g_list_foreach 和引用计数的说明（不必手动处理）
你看到的文档警告：
"If you want to iterate through the list and perform actions involving callbacks that might destroy the widgets, you must call g_list_foreach(result, (GFunc)g_object_ref, NULL) first..."
这源于 GTK C 层的内存管理机制：window_list_toplevels() 返回的是弱引用列表（即不增加 GObject 引用计数）。若你在遍历时调用 win.destroy()，该窗口可能在后续迭代中已被释放，导致崩溃。
但在 PyGTK（Python 2.7）中，Python 的垃圾回收会自动维护对存活窗口对象的强引用——只要你把窗口存入 windows 列表，它们就不会被意外释放。因此，你完全不需要手动调用 g_object_ref 或 g_object_unref。上述警告主要面向 C 开发者；PyGTK 已为你做了安全封装。
✅ 安全实践建议：
- 避免在 for win in windows: 循环体内直接调用 win.destroy() 后继续访问 win；
- 若需销毁，推荐先收集待关闭窗口，再统一处理：
to_close = [w for w in windows if "Analysis Result" in w.get_title()] for w in to_close: w.destroy()
? 如何确保窗口“立即绘制”？（解决白屏截图问题）
根本原因在于 GTK 的绘图是异步的：show() 后需让事件循环处理 expose-event。由于你未运行 gtk.main()，必须主动泵送事件队列：
# 在每个窗口 show() 后，或截图前插入：
while gtk.events_pending():
gtk.main_iteration()此调用会处理一次所有待决事件（包括重绘请求），确保窗口内容已渲染到屏幕，截图不再为空白。
? 总结
- ✅ 使用 gtk.window_list_toplevels() 获取所有打开的 Gtk.Window 实例；
- ✅ 按 win.get_title() 排序可稳定命名截图文件；
- ✅ 调用 gtk.main_iteration() 泵送事件，确保窗口实时绘制；
- ❌ 无需手动管理 GObject 引用计数（PyGTK 已自动处理）；
- ? 不要尝试 Wnck —— 它依赖 X11 窗口管理器，跨平台性差，且在 Gwyddion 嵌入环境中不可靠，也非 GTK 原生方案。
该方法完全兼容 Python 2.7 + PyGTK 2.x + Gwyddion 环境，无需修改现有工具代码，即可实现批量结果窗口的可控截图与清理。
