PySimpleGUI 使用浅谈

1. 背景

PySimpleGUI是一个简单易用的Python GUI库,它提供了一种直观且快速创建图形用户界面的方式。

2. 安装

复制代码
pip install PySimpleGUI

3. PySimpleGUI 的基本结构

一个基本的 PySimpleGUI 程序主要包括以下几个部分:

1. 导入 PySimpleGUI 库

2. 定义窗口的布局

在PySimpleGUI中,窗口的布局是使用一个二维列表来定义的。这个列表包含了要在窗口中显示的各种组件,如按钮、文本框等。每个组件都有一个或多个属性,如标识符、文本、颜色等。通过定义布局,可以确定窗口中组件的位置和排列方式

3.创建窗口

使用定义好的布局,可以创建一个窗口对象。窗口对象是应用程序与用户交互的主要界面。创建窗口时,需要提供一个标题作为窗口的名称,并将布局作为参数传递给sg.Window类的构造函数。

4. 事件循环

一旦窗口被创建,就需要进入事件循环,以便监听和响应用户的操作。在PySimpleGUI中,事件循环是通过window.read()方法实现的。该方法会阻塞程序的执行,直到发生一个事件(如按钮被点击、窗口关闭等)。一旦事件发生,window.read()方法会返回一个元组,其中包含事件和相应的值(如按钮的标识符、文本框的内容等)

5. 关闭窗口

在事件循环结束后,需要关闭窗口以释放资源。可以使用window.close()方法来关闭窗口对象。

下面是一个简单的示例:

复制代码
import PySimpleGUI as sg

# 定义窗口的布局
layout = [
    [sg.Text("Hello from PySimpleGUI")],
    [sg.Button("OK")]
]

# 创建窗口
window = sg.Window("Demo", layout)

# 事件循环
while True:
    event, values = window.read()
    if event == "OK" or event == sg.WIN_CLOSED:
        break

# 关闭窗口
window.close()

4. PySimpleGUI 的主要组件

PySimpleGUI 提供了许多预定义的组件,以下是一些常用组件的使用方法及其参数含义:

4.1 Text 组件

Text 组件用于在界面上显示一些文本。

复制代码
`sg.Text(`'This is some text')

主要参数:

  • text(str):要显示的文本。
  • size((int, int)):文本框的大小(字符宽度, 行数)。
  • auto_size_text(bool):如果为 True,文本框将根据内容自动调整大小。
  • click_submits(bool):如果为 True,当用户点击文本时,将触发一个事件。

4.2 Button 组件

Button 组件用于创建一个按钮。

复制代码
`sg.Button(`'Click me')

主要参数:

  • button_text(str):按钮上显示的文本。
  • size((int, int)):按钮的大小(字符宽度, 行数)。
  • auto_size_button(bool):如果为 True,按钮将根据内容自动调整大小。
  • bind_return_key(bool):如果为 True,当用户按下回车键时,将触发按钮点击事件。

4.3 InputText 组件

InputText 组件用于创建一个文本输入框。

复制代码
`sg.InputText(`'Default text')

主要参数:

  • default_text(str):输入框的默认文本。
  • size((int, int)):输入框的大小(字符宽度, 行数)。
  • password_char(str):如果设置,输入框将隐藏输入,显示此字符。

4.4 Checkbox 组件

Checkbox 组件用于创建一个复选框。

复制代码
`sg.Checkbox(`'Check me')

主要参数:

  • text(str):复选框旁边显示的文本。
  • default(bool):复选框的默认状态,如果为 True,复选框将被选中。

4.5 RadioButton 组件

RadioButton 组件用于创建一组单选按钮。

复制代码
`sg.Radio(`'Option 1', "RADIO1", default=True),
sg.Radio('Option 2', "RADIO1"), sg.Radio('Option 3', "RADIO1"), 

主要参数:

  • text(str):单选按钮旁边显示的文本。
  • group_id(str):单选按钮的组ID,同一组的单选按钮共享同一个组ID。
  • default(bool):单选按钮的默认状态,如果为 True,单选按钮将被选中。

4.6 主题(Theme)

主题用于改变应用程序的整体外观。

主要参数:

  • theme(str):主题名称,可选值包括:'Default'(默认主题)、'DarkAmber'、'DarkBlue'、'DarkBrown'等。

4.7 图标(Icon)

图标用于设置应用程序的图标。

主要参数:

  • icon(str):图标文件的路径

4.8 布局行与列(Rows and Columns)

布局行和列可用于创建复杂的界面结构。

主要参数:

  • sg.Columnsg.Row中放置其他组件的列表。
  • element_justification(str):控制组件在列中的水平对齐方式,可选值有'center'、'left'、'right'。

4.9 分割线(Separator)

分割线用于在布局中添加分割线。

主要参数:无

使用小栗子:

复制代码
import PySimpleGUI as sg

# 设置主题和图标
sg.theme('DarkAmber')
sg.set_options(icon='my_icon.ico')

# 定义布局
layout = [
    [sg.Text('Hello from PySimpleGUI!', size=(30, 1), justification='center')],
    [sg.Image(filename='my_image.png')],
    [sg.HorizontalSeparator()],
    [sg.Text('Column 1'), sg.Text('Column 2')],
    [sg.Input(key='-IN-'), sg.Input(key='-IN2-')],
    [sg.Button('OK', image_filename='button_image.png'), sg.Button('Cancel')]
]

# 创建窗口
window = sg.Window('Demo', layout)

# 事件循环
while True:
    event, values = window.read()
    if event == sg.WINDOW_CLOSED or event == 'Cancel':
        break

# 关闭窗口
window.close()

5. 打包成可执行程序

要将 PySimpleGUI(或任何 Python 脚本)打包成一个可执行程序,你可以使用 PyInstaller。PyInstaller 可以将 Python 程序打包成一个单一的可执行文件,这个文件可以在没有 Python 环境的计算机上运行。

以下是一个简单的步骤来打包 PySimpleGUI 程序:

  1. 安装 PyInstaller。在命令行中输入以下命令:

    复制代码
    `pip install pyinstaller
    `
  2. 使用 PyInstaller 打包你的 PySimpleGUI 程序。假设你的程序名为 my_program.py,你可以在命令行中输入以下命令:

    复制代码
    `pyinstaller --onefile --windowed my_program.py
    `
    • --onefile 参数表示你想要将你的程序打包成一个单一的可执行文件。
    • --windowed 参数表示你的程序是一个 GUI 程序,不需要命令行窗口。

完成以上步骤后,你会在 dist 目录下找到一个名为 my_program.exe(在 Windows 上)或 my_program(在 Linux 和 macOS 上)的可执行文件。你可以在没有 Python 环境的计算机上运行这个文件。

注意,PyInstaller 打包的可执行文件是平台相关的,也就是说,你在 Windows 上打包的程序不能在 Linux 或 macOS 上运行,反之亦然。如果你想要在不同的平台上运行你的程序,你需要在每个平台上分别打包。

另外,虽然 PyInstaller 可以打包大多数 Python 程序,但是有些程序可能需要特殊的处理,例如包含复杂依赖关系或需要访问特定文件的程序。在这种情况下,你可能需要修改 PyInstaller 的配置文件或使用其他打包工具。