本文介绍在 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 应用中。
