在 PySimpleGUI 中，sg.Window 是创建图形用户界面（GUI）窗口的核心类，其属性和方法支持窗口的定制化与交互逻辑实现。以下是关键属性和方法的分类说明：
核心属性
-
窗口标题与尺寸
title：窗口标题栏显示的文本（通过sg.Window('标题')设置）。size：窗口初始尺寸，格式为(宽度, 高度)（如size=(400, 300)）。resizable：布尔值，控制窗口是否可调整大小（默认False）。
-
布局与控件
layout：窗口内控件的排列结构，通过嵌套列表定义（如[[sg.Text('文本'), sg.Input()]]）。finalize：布尔值，若为True，窗口创建后立即渲染，允许动态修改控件（如finalize=True）。
-
视觉与行为
no_titlebar：布尔值，移除标题栏（默认False）。icon：设置窗口图标（需提供文件路径）。default_button：指定默认按钮（用户按回车时触发）。font：全局字体设置（如font=('微软雅黑', 12)）。
-
事件与交互
return_keyboard_events：布尔值，若为True，键盘按键会作为事件返回。use_default_focus：布尔值，控制是否自动聚焦到第一个可交互控件。
核心方法
-
窗口生命周期管理
read(timeout=None)：启动事件循环，阻塞程序直到用户交互。timeout（毫秒）：超时后自动返回(None, None)，避免无限阻塞。- 返回
(event, values)元组：event为触发事件（如按钮文本），values为输入控件的值（字典形式）。
close()：关闭窗口并释放资源。hide()/un_hide()：隐藏或显示窗口（多窗口管理时常用）。
-
动态控件操作
FindElement(key)/Element(key)：通过控件的key属性获取控件对象。[key]简写：直接通过window[key]访问控件（如window['-INPUT-'].update('新文本')）。update()：更新控件属性（如文本、颜色、可见性等）。- 示例：
window['-BUTTON-'].update(disabled=True)禁用按钮。
- 示例：
-
布局与窗口调整
layout(new_layout)：动态替换窗口布局（需先调用finalize=True）。refresh()：强制重绘窗口（通常在动态修改后调用）。
-
多窗口支持
read_all_windows()：同时读取多个窗口的事件（返回(window, event, values)元组）。
示例代码
import PySimpleGUI as sg# 定义布局
layout = [[sg.Text('请输入姓名:', key='-LABEL-')],[sg.Input(key='-INPUT-')],[sg.Button('提交', key='-SUBMIT-'), sg.Button('退出', key='-EXIT-')]
]# 创建窗口
window = sg.Window('示例窗口', layout, finalize=True, size=(300, 150))# 事件循环
while True:event, values = window.read()if event == sg.WIN_CLOSED or event == '-EXIT-':breakelif event == '-SUBMIT-':name = values['-INPUT-']sg.popup(f'你好, {name}!')window['-LABEL-'].update(text='输入已提交:') # 动态更新文本window.close()
关键点总结
- 属性：通过构造函数参数设置（如
size、title），部分需配合finalize=True动态修改。 - 方法：
read()处理交互，update()动态更新控件，多窗口用read_all_windows()。 - 事件驱动：所有交互通过事件（
event）触发，结合values获取输入数据。
通过灵活组合这些属性和方法，可以快速构建功能丰富的 GUI 应用。
