在 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 运行环境，无需修改原有工具代码，即可实现鲁棒的窗口批量截图自动化。
