sg: window对象 常用方法

在 PySimpleGUI 中，window 对象除了 .get() 和 .update() 方法外，还提供了许多其他方法来控制窗口的行为和交互。以下是一些常用的方法：

---

1. 窗口生命周期管理

• .close()
  关闭窗口并释放资源。

  window.close()
  

• .finalize()
  在窗口显示前强制完成布局初始化（通常用于动态更新后）。

  window.finalize()
  

• .hide() / .un_hide()
  隐藏或显示窗口（不关闭）。

  window.hide()
  window.un_hide()
  

• .disappear() / .reappear()
  类似 .hide() 和 .un_hide()，但可能更高效。

---

2. 事件循环控制

• .read(timeout=None, timeout_key='__TIMEOUT__')
  读取事件，可选超时设置（毫秒）。

  event, values = window.read(timeout=1000)  # 1秒超时
  

• .perform_long_operation(func, callback)
  在后台线程运行函数，完成后触发回调。

---

3. 元素操作

• .find_element(key)
  通过键（key）获取窗口中的元素对象。

  element = window.find_element('-INPUT-')
  

• .extend_layout(container, layout)
  动态扩展布局（如向列或框架添加新元素）。

  window.extend_layout(window['-COLUMN-'], [[sg.Text('New text')]])
  

• .bring_to_front()
  将窗口置顶显示。

---

4. 状态与属性

• .set_title(title)
  修改窗口标题。

  window.set_title('新标题')
  

• .get_screen_size()
  获取屏幕分辨率。

  screen_width, screen_height = window.get_screen_size()
  

• .current_location()
  获取窗口当前坐标（左上角）。

  x, y = window.current_location()
  

• .move(x, y)
  移动窗口到指定坐标。

  window.move(100, 100)
  

---

5. 键盘/鼠标控制

• .bind() / .unbind()
  绑定或解绑键盘快捷键。

  window.bind('<Control-s>', '_SAVE_')  # 绑定 Ctrl+S
  

• .set_cursor(cursor='arrow')
  设置鼠标光标样式（如 'arrow', 'wait', 'hand'）。

---

6. 其他实用方法

• .start_thread(func, *args, **kwargs)
  在后台线程运行函数（避免界面卡死）。

  window.start_thread(lambda: print('Running in thread'))
  

• .save_to_disk(filename) / .load_from_disk(filename)
  保存或加载窗口布局到文件（实验性功能）。

• .refresh()
  强制重绘窗口（解决某些显示问题）。

---

示例代码

import PySimpleGUI as sglayout = [[sg.Input(key='-INPUT-')], [sg.Button('清空')]]
window = sg.Window('示例', layout)while True:event, values = window.read()if event == sg.WIN_CLOSED:breakelif event == '清空':window['-INPUT-'].update("")  # 清空输入框window.set_title('已清空')    # 修改标题window.move(200, 200)        # 移动窗口window.close()

---

注意事项

• 部分方法（如 .extend_layout()）需要 PySimpleGUI 版本 ≥ 4.60.0。
• 动态更新布局时，建议结合 finalize() 确保界面正确渲染。

如果需要更详细的信息，可以参考 PySimpleGUI 官方文档。