在PySimpleGUI中,以下是一些常见的功能元素和函数的缩写形式及其说明:
常用元素缩写
-
文本元素
sg.T
或sg.Txt
→sg.Text
用于显示单行或多行文本,支持事件触发(enable_events=True
)。
-
输入框
sg.I
→sg.Input
单行文本输入框,可通过key
标识获取用户输入。
-
按钮
sg.B
→sg.Button
基础按钮,支持绑定事件(如点击事件)。
-
复选框
sg.CB
→sg.Checkbox
返回布尔值,表示是否被选中。
-
单选按钮
sg.R
→sg.Radio
分组单选按钮,同一组内只能选择一个。
-
下拉列表
sg.Combo
(无直接缩写,但常用简写)
支持从列表中选择一项,返回字符串。
-
列表框
sg.Listbox
(无直接缩写)
支持多选或单选,返回选中的列表。
-
滑块
sg.Slider
(无直接缩写)
数值调节控件,支持范围设置。
-
多行文本框
sg.Multiline
(无直接缩写)
支持多行文本输入/输出,可绑定打印功能。
-
图像显示
sg.Image
(无直接缩写)
支持PNG、GIF等格式,可显示动画。
常用弹窗函数缩写
-
基础弹窗
sg.popup
→ 显示简单消息框。
-
带按钮的弹窗
sg.popup_ok
→ 带“OK”按钮。sg.popup_yes_no
→ 带“Yes/No”按钮。sg.popup_cancel
→ 带“Cancel”按钮。sg.popup_error
→ 带红色“Error”按钮。
-
输入弹窗
sg.popup_get_text
→ 获取用户输入的文本。sg.popup_get_file
→ 选择文件(支持多选和类型过滤)。sg.popup_get_folder
→ 选择文件夹。
-
日期选择
sg.popup_get_date
→ 显示日历选择窗口。
-
通知弹窗
sg.popup_notify
→ 右下角淡入淡出通知。
窗口操作缩写
-
窗口创建
sg.Window
→ 创建主窗口,布局通过列表嵌套定义。
-
事件读取
window.read()
→ 阻塞式读取用户操作(如按钮点击)。window.read(timeout=100)
→ 非阻塞式读取,超时返回。
-
元素更新
window[key].update()
→ 动态更新元素属性(如文本、颜色)。
其他实用缩写
-
快捷键绑定
- 在元素参数中设置
bind_return_key=True
,使回车键触发按钮事件。
- 在元素参数中设置
-
布局辅助
sg.Column
(非官方缩写,常用sg.Col
)→ 创建列布局。sg.Frame
→ 创建带标题的框架。
-
进度条
sg.one_line_progress_meter
→ 显示横向进度条。