如何在 Pyglet 中以编程方式恢复（取消最小化）窗口

本文介绍在 Pyglet 中安全、跨安装兼容地恢复已最小化的窗口的方法，重点推荐基于 pywin32 的 win32gui.ShowWindow 方案，并提供可直接复用的封装函数、使用示例及关键注意事项。

本文介绍在 pyglet 中安全、跨安装兼容地恢复已最小化的窗口的方法，重点推荐基于 `pywin32` 的 `win32gui.showwindow` 方案，并提供可直接复用的封装函数、使用示例及关键注意事项。

Pyglet 本身未在公开 API 中提供 restore() 或 unminimize() 方法，其 Window.minimize() 可调用，但官方文档与源码均未暴露对应的恢复接口。直接修改 pyglet/window/win32/__init__.py（如旧论坛方案）虽技术上可行，但会破坏包隔离性、难以维护且不适用于虚拟环境或多版本部署场景，不推荐生产使用。

更现代、稳健的实践是借助 windows 平台原生 API 封装库 pywin32，通过 win32gui.ShowWindow 显式发送 SW_RESTORE 指令。该方法无需侵入 Pyglet 源码，仅需额外安装轻量依赖，兼容所有主流 Pyglet 版本（1.5+ 至 2.x），且行为与系统级窗口管理器完全一致。

✅ 推荐实现：封装可复用的 restore 函数

import pyglet import win32gui import win32con  def restore_window(window: pyglet.window.Window) -> bool:     """     将指定 Pyglet 窗口从最小化状态恢复（还原）。      注意：仅适用于 Windows 平台；要求已安装 pywin32（pip install pywin32）     返回 True 表示调用成功（无论当前窗口状态如何），False 表示 hwnd 无效。     """     if not hasattr(window, '_hwnd') or not window._hwnd:         return False     return bool(win32gui.ShowWindow(window._hwnd, win32con.SW_RESTORE))

? 使用示例

# 创建窗口并最小化 window = pyglet.window.Window(800, 600, "Restore Demo") @window.event def on_key_press(symbol, modifiers):     if symbol == pyglet.window.key.R:         restore_window(window)  # 按 R 键恢复窗口         print("Window restored.")  # 手动触发最小化（例如启动后自动最小化） pyglet.clock.schedule_once(lambda dt: window.minimize(), 2.0)  pyglet.app.run()

⚠️ 关键注意事项

• 平台限制：此方案仅支持 Windows。linux/macos 需分别使用 X11 或 AppKit 原生调用，Pyglet 当前无跨平台统一抽象，故 restore_window 应配合 sys.platform 做运行时判断。
• 依赖安装：执行 pip install pywin32 后，建议运行 python Scripts/pywin32_postinstall.py -install（Windows）确保 COM 注册正确。
• 窗口句柄有效性：window._hwnd 是 Pyglet Win32 后端的私有属性，在非 Win32 环境下不存在。生产代码中应添加平台检查与属性存在性验证。
• 状态无关性：SW_RESTORE 对非最小化窗口无副作用（如已最大化或正常显示，调用后保持原状），因此可安全重复调用。

✅ 替代思路（不推荐但可了解）

• 使用 window.set_location(x, y) + window.set_size(w, h) 组合“模拟”恢复：不可靠，无法还原被系统记忆的原始尺寸/位置，且无法触发窗口管理器的动画与焦点逻辑。
• 监听 on_restore 事件：Pyglet 不提供该事件钩子，亦无对应机制。

综上，win32gui.ShowWindow(hwnd, SW_RESTORE) 是当前 Windows 下最简洁、可靠、符合系统规范的恢复方案。将其封装为健壮函数并做好平台与异常防护，即可无缝集成至任何 Pyglet 应用中。