使用 PySimpleGUI 轻松为你的程序和脚本添加 GUI

在五分钟内创建一个自定义 GUI。
335 位读者喜欢这篇文章。

很少有人像双击 .exe 文件一样双击 .py 文件来运行 Python 程序。当一个典型的用户（非程序员类型）双击一个 .exe 文件时，他们期望它弹出一个可以与之交互的窗口。虽然使用 tkinter 的 GUI 可以通过标准的 Python 安装实现，但很少有程序这样做。

如果将 Python 程序打开到 GUI 中变得非常容易，即使是完全的初学者也能做到呢？会有人关心吗？会有人使用它吗？很难回答，因为到目前为止，构建自定义 GUI 并不容易。

似乎在为 Python 程序/脚本添加 GUI 的能力方面存在差距。完全的初学者只能使用命令行，而许多高级程序员不想花时间编写 tkinter GUI。

GUI 框架

Python 并不缺乏 GUI 框架。 Tkinter、WxPython、Qt 和 Kivy 是一些主要的软件包。 此外，还有许多“包装”主要软件包的简化 GUI 软件包，包括 EasyGUI、PyGUI 和 Pyforms。

问题是，初学者（那些经验不足六周的人）甚至无法学习最简单的主要软件包。 这使得包装器软件包成为一个潜在的选择，但对于大多数新用户来说，构建自定义 GUI 布局仍然很困难或不可能。 即使有可能，包装器仍然需要大量的代码。

PySimpleGUI 试图通过提供一个超级简单、易于理解的 GUI 接口来解决这些 GUI 挑战，该接口可以轻松自定义。 即使许多复杂的 GUI 在使用 PySimpleGUI 时也只需要不到 20 行的代码。

秘诀

PySimpleGUI 对新手来说更胜一筹的原因是，该软件包包含用户通常需要编写的大部分代码。 按钮回调由 PySimpleGUI 处理，而不是用户的代码。 初学者很难掌握函数的概念，期望他们在最初几周内理解回调函数是勉强的。

对于大多数 GUI，排列 GUI 小部件通常需要几行代码……至少每个小部件需要一两行代码。 PySimpleGUI 使用“自动打包器”自动创建布局。 无需 pack 或 grid 系统即可布局 GUI 窗口。

最后，PySimpleGUI 以巧妙的方式利用 Python 语言结构，缩短了代码量并以直接的方式返回 GUI 数据。 在表单布局中创建小部件时，它会在适当的位置进行配置，而不是在几行代码之外。

什么是 GUI？

大多数 GUI 做一件事：从用户那里收集信息并返回。 从程序员的角度来看，这可以概括为一个函数调用，如下所示

button, values = GUI_Display(gui_layout)

大多数 GUI 期望的是单击的按钮（例如，确定、取消、保存、是、否等）以及用户输入的值。 GUI 的本质可以归结为一行代码。

这正是 PySimpleGUI 的工作方式（对于简单的 GUI）。 当调用显示 GUI 时，在单击关闭表单的按钮之前，什么都不会执行。

还有更复杂的 GUI，例如那些在单击按钮后不关闭的 GUI。 示例包括机器人的远程控制界面和聊天窗口。 这些复杂的表单也可以使用 PySimpleGUI 创建。

制作一个快速的 GUI

什么时候 PySimpleGUI 有用？ 立即，无论何时需要 GUI。 创建和尝试 GUI 只需不到五分钟的时间。 制作 GUI 的最快方法是从 PySimpleGUI Cookbook 中复制一个。 按照以下步骤操作

  • 找到一个看起来类似于你想要创建的 GUI
  • 从 Cookbook 中复制代码
  • 将其粘贴到你的 IDE 中并运行它

让我们看看这本书中的第一个配方。

import PySimpleGUI as sg

# Very basic form.  Return values as a list
form = sg.FlexForm('Simple data entry form')  # begin with a blank form

layout = [
          [sg.Text('Please enter your Name, Address, Phone')],
          [sg.Text('Name', size=(15, 1)), sg.InputText('name')],
          [sg.Text('Address', size=(15, 1)), sg.InputText('address')],
          [sg.Text('Phone', size=(15, 1)), sg.InputText('phone')],
          [sg.Submit(), sg.Cancel()]
         ]

button, values = form.LayoutAndRead(layout)

print(button, values[0], values[1], values[2])

这是一个相当大的表单。

PySimpleGUI data entry form

如果你只需要收集一些值，并且它们基本上都是字符串，你可以复制这个配方并修改它以满足你的需求。

你甚至可以在五行代码中创建一个自定义 GUI 布局。

import PySimpleGUI as sg

form = sg.FlexForm('My first GUI')

layout = [ [sg.Text('Enter your name'), sg.InputText()],
           [sg.OK()] ]

button, (name,) = form.LayoutAndRead(layout)

PySimpleGUI form from 5 lines of code

在五分钟内创建一个自定义 GUI

如果你有一个简单的布局，你应该能够在不到五分钟的时间内通过修改 Cookbook 中的代码来在 PySimpleGUI 中创建一个自定义布局。

小部件在 PySimpleGUI 中被称为元素。 这些元素的拼写与你将它们输入到 Python 代码中的方式完全相同。

核心元素

Text
InputText
Multiline
InputCombo
Listbox
Radio
Checkbox
Spin
Output
SimpleButton
RealtimeButton
ReadFormButton
ProgressBar
Image
Slider
Column

快捷方式列表

PySimpleGUI 还有两种类型的元素快捷方式。 一种类型只是完全相同的元素的其他名称（例如，T 而不是 Text）。 第二种类型使用特定设置配置一个元素，免除你指定所有参数（例如，Submit 是一个文本为“提交”的按钮）

T = Text
Txt = Text
In = InputText
Input = IntputText
Combo = InputCombo
DropDown = InputCombo
Drop = InputCombo

按钮快捷方式

许多常用按钮已作为快捷方式实现。 这些包括

FolderBrowse
FileBrowse
FileSaveAs
Save
Submit
OK
Ok
Cancel
Quit
Exit
Yes
No

还有更多通用按钮功能的快捷方式。

SimpleButton
ReadFormButton
RealtimeButton

这些是你可以在 PySimpleGUI 中选择的所有 GUI 小部件。 如果其中一个不在这些列表中，则它不会出现在你的表单布局中。

GUI 设计模式

编程和开发

GUI 中往往不会改变的是设置和显示窗口的调用。 元素的布局是每个程序之间不同的地方。

这是上面示例中删除了布局的代码

import PySimpleGUI as sg

form = sg.FlexForm('Simple data entry form')
# Define your form here (it's a list of lists)
button, values = form.LayoutAndRead(layout)

大多数 GUI 的流程是

  • 创建表单对象
  • 将 GUI 定义为列表的列表
  • 显示 GUI 并获取结果

这些就是你在 PySimpleGUI 的设计模式中看到的内容。

GUI 布局

要创建自定义 GUI，首先将你的表单分解为行，因为表单是一次定义一行。 然后一个接一个地放置元素，从左到右工作。

结果是一个“列表的列表”，看起来像这样

layout = [  [Text('Row 1')],
            [Text('Row 2'), Checkbox('Checkbox 1', OK()), Checkbox('Checkbox 2'), OK()] ]

此布局产生此窗口

PySimpleGUI custom data entry form

显示 GUI

完成布局并复制了设置和显示表单的代码行后，就可以显示表单并从用户那里获取值了。

这是显示表单并提供结果的代码行

button, values = form.LayoutAndRead(layout)

表单返回两个值：单击的按钮的文本和用户输入表单的值的列表。

如果显示示例表单，并且用户除了单击确定按钮之外什么也不做，则结果将是

button == 'OK'
values == [False, False]

复选框元素返回 True 或 False 值。 因为复选框默认为未选中，所以返回的值均为 False。

显示结果

获得 GUI 中的值后，最好检查变量中的值。 与其使用 print 语句打印出来，不如坚持 GUI 的想法并将数据输出到窗口。

PySimpleGUI 有许多消息框可供选择。 传递给消息框的数据显示在一个窗口中。 该函数接受任意数量的参数。 你可以简单地指示你想在调用中看到的所有变量。

PySimpleGUI 中最常用的消息框是 MsgBox。 要显示上一个示例中的结果，请编写

MsgBox('The GUI returned:', button, values)

整合在一起

既然你了解了基础知识，让我们将尽可能多的 PySimpleGUI 元素组合到一个表单中。 此外，为了使其外观更漂亮，我们将“外观”更改为绿色和棕褐色配色方案。

import PySimpleGUI as sg

sg.ChangeLookAndFeel('GreenTan')

form = sg.FlexForm('Everything bagel', default_element_size=(40, 1))

column1 = [[sg.Text('Column 1', background_color='#d3dfda', justification='center', size=(10,1))],
           [sg.Spin(values=('Spin Box 1', '2', '3'), initial_value='Spin Box 1')],
           [sg.Spin(values=('Spin Box 1', '2', '3'), initial_value='Spin Box 2')],
           [sg.Spin(values=('Spin Box 1', '2', '3'), initial_value='Spin Box 3')]]
layout = [
    [sg.Text('All graphic widgets in one form!', size=(30, 1), font=("Helvetica", 25))],
    [sg.Text('Here is some text.... and a place to enter text')],
    [sg.InputText('This is my text')],
    [sg.Checkbox('My first checkbox!'), sg.Checkbox('My second checkbox!', default=True)],
    [sg.Radio('My first Radio!     ', "RADIO1", default=True), sg.Radio('My second Radio!', "RADIO1")],
    [sg.Multiline(default_text='This is the default Text should you decide not to type anything', size=(35, 3)),
     sg.Multiline(default_text='A second multi-line', size=(35, 3))],
    [sg.InputCombo(('Combobox 1', 'Combobox 2'), size=(20, 3)),
     sg.Slider(range=(1, 100), orientation='h', size=(34, 20), default_value=85)],
    [sg.Listbox(values=('Listbox 1', 'Listbox 2', 'Listbox 3'), size=(30, 3)),
     sg.Slider(range=(1, 100), orientation='v', size=(5, 20), default_value=25),
     sg.Slider(range=(1, 100), orientation='v', size=(5, 20), default_value=75),
     sg.Slider(range=(1, 100), orientation='v', size=(5, 20), default_value=10),
     sg.Column(column1, background_color='#d3dfda')],
    [sg.Text('_'  * 80)],
    [sg.Text('Choose A Folder', size=(35, 1))],
    [sg.Text('Your Folder', size=(15, 1), auto_size_text=False, justification='right'),
     sg.InputText('Default Folder'), sg.FolderBrowse()],
    [sg.Submit(), sg.Cancel()]
     ]

button, values = form.LayoutAndRead(layout)
sg.MsgBox(button, values)

这看起来可能有很多代码，但是尝试直接在 tkinter 中编写相同的 GUI 布局，你很快就会意识到它有多么小。

PySimpleGUI advanced custom data entry form

最后一行代码打开一个消息框。 它是这样显示的

PySimpleGUI custom message box

消息框调用的每个参数都显示在新行上。 消息框中有两行文本； 第二行很长并且换行了很多次

花点时间将结果值与 GUI 配对，以了解如何创建和返回结果。

为你的程序或脚本添加 GUI

如果你有一个使用命令行的脚本，你无需为了添加 GUI 而放弃它。 一个简单的解决方案是，如果在命令行上没有给出任何参数，则运行 GUI。 否则，像今天一样执行命令行。

这种逻辑是所有需要的

if len(sys.argv) == 1:
	# collect arguments from GUI
else:
    # collect arguements from sys.argv

快速启动和运行 GUI 的最简单方法是从 PySimpleGUI Cookbook 中复制并修改一个配方。

玩得开心！ 为你厌倦了手动运行的脚本增添趣味。 花费 5 或 10 分钟来玩演示脚本。 你可能会发现已经存在一个完全满足你需要的脚本。 如果没有，你会发现创建自己的脚本很简单。 如果你真的迷失了，你只投入了 10 分钟。

资源

安装

PySimpleGUI 适用于运行 tkinter 的所有系统，包括 Raspberry Pi，并且需要 Python 3

pip install PySimpleGUI

文档

标签
Python

24 条评论

Avatar
Jake | 2018年8月29日
还没有读者喜欢这个。

感谢您写了这篇文章。我永远都是一个初学者，因为我对严肃的编程没有兴趣。只是喜欢涂鸦。在过去的几周里，我一直在考虑尝试运行一些在Windows下可用的非常简单的“编程”/创意软件包。

甚至HTA也出现在我的脑海中。一直在考虑在WINE或虚拟化环境下进行。Linux根本不适合简单... 即使是bash也可能过度设计。PySimpleGUI看起来很完美（对于某些解决方案）。这可能会吸引我更认真地使用Python。

Avatar
Robert McConnell | 2018年8月30日
还没有读者喜欢这个。

这是对一个很棒的解决方案的优秀介绍，它解决了一个一直困扰我的难题。我对代码只有两个小问题。

1. 由于该库需要Python 3，因此第一行必须是

#! /usr/bin/python3

2. 同样，对于Python 3，您必须使用pip3进行安装。否则它最终会进入Python2库集合。

现在，将此与psycopg2结合以在数据库中插入和更新记录的最有效方法是什么？还要考虑到表已经有些规范化，因此每个记录可能分布在两到三个不同的表中，并且某些字段的值列表必须从静态数据表中获取。

Avatar
Mike Barnett | 2018年8月30日
还没有读者喜欢这个。

如果问题/应用程序具有GUI或可以从GUI中受益，那么PySimpleGUI是一个不错的起点。如果它不适合，您可以快速排除它并继续前进。

如果项目看起来可能是一个候选者，请花2分钟时间在Cookbook中查找大致匹配项。复制、粘贴并运行Recipe代码。然后只需修改代码以匹配您的应用程序即可。

目标是使向软件添加一个体面的外观GUI变得微不足道。如果能让初学者更容易上手，那么在教育中尽早将学生介绍给GUI会更好。

我对你的建议是跳进去尝试一下。让一些东西运行起来。让任何东西运行起来。然后修改它甚至重新开始。重点是，您拥有一个工作环境，一块空白的画布。

Avatar
Robert McConnell | 2018年9月1日
还没有读者喜欢这个。

看过之后，它不适合我。虽然从静态表中检索id和显示文本非常容易，但我只需要在列表框中显示文本，但返回与选择匹配的id，因为这将存储在新记录中。也许这对于未来的版本来说将是一个有用的增强功能？

Avatar
Mike Barnett | 2018年9月2日
还没有读者喜欢这个。

如果“表”是您需要交互的基本事物，那么PySimpleGUI还无法提供以交互方式执行此操作的方法。

显示表格相对容易，并且结果非常好
https://user-images.githubusercontent.com/13696193/44960497-c667fd80-ae…

如果您想尝试，这是代码

layout = [[sg.T('Table Test')]]
for i in range(20)
row = [sg.T(f'Row {i} ', size=(10,1))]
layout.append([sg.T(f'{i}{j}', size=(4,1), background_color='white', pad=(1,1)) for j in range(10)])
sg.FlexForm('Table').LayoutAndRead(layout)

有两个缺失的特性使得这个包不是数据库类型操作的最佳选择
1. 表格
2. 可滚动窗口

我不知道tkinter中是否有“table”小部件。我查看了一些提议的解决方案，但还没有任何解决方案脱颖而出。第一步是使Column Element可滚动。

应该注意的是，PySimpleGUI的主要任务是实现“Simple GUI”。

Avatar
Mike Barnett | 2018年9月2日
还没有读者喜欢这个。

如果您有功能创意或发现限制，我建议您编写一个问题并将其发布在GitHub网站上。

我对您在列表框上尝试的操作感到困惑。就这些事情进行交流的最佳方式是通过GitHub。

Avatar
Robert McConnell | 2018年9月2日
还没有读者喜欢这个。

这个过程很简单。我有一个永远不会改变的铁路表。它包括一个键（id）、长名称和短名称。因此，我在CSV格式中最重要的两个记录是

1, Pennsylvania Railroad, PRR
2, Coudersport and Port Allegany Railroad, CPA

我做一个SQL选择，选择id和短名称以获取一个列表以供选择，然后在列表框中显示该列表。一旦用户选择，我需要返回id以存储在新记录中。

我无法接受GitHub的服务条款，所以这甚至不是一个遥远的可能性。

Avatar
Mike Barnett | 2018年9月4日
还没有读者喜欢这个。

明白了。刚刚完成了可滚动Column Elements的创建，这为表格和您描述的应用程序铺平了道路。

是什么GitHub服务条款阻止了您？也许它被错误地陈述了。

Avatar
Robert McConnell | 2018年9月6日
还没有读者喜欢这个。

哪些条款？我几乎不知道从哪里开始。但让我给你前三名。

1 Q节。赔偿：如果某个白痴决定因为感知到的轻视或因为他想窃取我的作品而起诉我，我将不得不卖掉我拥有的所有东西来支付任何可以回应该投诉的律师的律师费。在这种情况下，我不可能赔偿任何人。如果您认为这种情况不太可能发生，请阅读JMRI的历史。

此外，根据B3段，他们希望青少年遵守此要求，虽然我认为法院不会允许这样做，但孩子们的父母仍然需要花费很多钱才能找到答案。

2. B4段说，当网站被黑客入侵时，用户仍然对违规行为负责，即使他们无法控制后端安全性。这对于没有实际谈判的标准商业合同来说太典型了。它变成了一个单方面的文件，所有的风险都转嫁给用户。这给我提供了一个要么接受要么放弃的决定，我选择放弃。

3. R节未能以任何有意义的方式定义“重大变更”，只有一个薄弱的例子列出。这为律师留下了太多的回旋余地，他们完全有可能决定出售所有收集到的客户信息，在半夜完成对网页的更改，并在太阳升起之前将钱存入银行。既然他们归微软所有，我不得不认为这是一个非常现实的可能性。

Avatar
Barlafuss | 2018年9月7日
还没有读者喜欢这个。

它在KDE/Plasma环境中工作吗？只是尝试将一个示例 + PySimpleGUI.py 复制到一个目录中并运行，但我只看到一个非常小的“十字”，就像鼠标指针，没有更多...

Avatar
Mike Barnett | 2018年9月7日
还没有读者喜欢这个。

我将在GitHub上打开一个问题。请访问并输入更多信息，以便可以进行调试（Python版本，Linux版本等）。

Avatar
Noah F San | 2018年9月24日
还没有读者喜欢这个。

PySimpleGUI似乎很适合我需要构建的一个小型GUI应用程序，但它_必须_基于Python 2.7。下面的代码是我必须添加到PySimpleGUI.py顶部的所有代码，加上（如评论中所述）在*()内部为每个super()调用添加一个函数调用（未经Python 3测试！）。但是，一个让我困惑的“陷阱”是，我必须将方法调用中的每个(args)移动到命名（“关键字args”）参数之后的位置。这绝对不符合Python约定，但它可以修复错误...

import platform

sVsn = platform.python_version()[0]

if sVsn == '2'
__metaclass__ = type # Python v.2.X所需

def fSuprArgs(self)
return () if sVsn != '2' else (self.__class__, self)

# 将 *(fSuprArgs(self)) 作为参数放在每次调用 super() 中

Avatar
Mike Barnett | 2018年9月25日
还没有读者喜欢这个。

你是说你设法让PySimpleGUI在Python 2.7下工作了？

如果是，请将文件发布到GitHub（或您选择的其他任何位置）。这个请求不时出现。我本周早些时候收到一个。

Avatar
Noah F San | 2018年9月25日
还没有读者喜欢这个。

是的，这是我项目的一个要求。只需将上面的代码添加到 PySmpleGUI.py 的顶部，并在每个 super() 调用中插入该函数：super(*(fSuprArgs(self)))，将所有 *args 移动到其出现的任何参数列表的最后一个位置，就完成了。

小心，此网页上的缩进会错乱...

我已经将这些更改授权为 CC-BY-SA 许可，无论这意味着什么，请随意使用。

请注意：仅在 Python 2.7.12 上测试过，并且**没有在 Python 3 上测试过！**

此外，我发现许多小部件会感到困惑，因为它们期望颜色值元组作为第一个参数，所以我总是填充 (1, 1)，这样可以防止其他错误。

Avatar
Noah F San | 2018年9月25日
还没有读者喜欢这个。

回复我自己：看起来我误解了参数类型基数。下面的链接表明，“正式”关键字参数_可以_出现在 *args 之前，但是 *args 必须不能出现在 **kwargs 之前，当一起使用时。所以，防止错误的更改仍然是合法的 Python，但是我当然不知道为什么它有效。

http://www.network-theory.co.uk/docs/pytut/KeywordArguments.html

Avatar
Mike Barnett | 2018年9月25日
还没有读者喜欢这个。

我进行了所有这些更改，并将 *args 移动到所有函数的末尾。

而且，它**有效了！**至少在我尝试的一个简单表单上。前面还有更多工作要做。我对这个结果感到**震惊！**我非常感谢你！！

Avatar
Mike Barnett | 2018年9月25日
还没有读者喜欢这个。

最后一条消息...

感谢您的鼓励和代码帮助，我刚刚将 PySimpleGUI27 发布到 PyPI

我测试了很多次，但我无法测试 PyPI 版本。它应该工作得很好。你做了一件了不起的事情！

Avatar
Noah F San | 2018 年 9 月 26 日
还没有读者喜欢这个。

很抱歉我没有更清楚地说明 v.2.7 的更改应该如何工作。虽然我没有在 v.3.x 上进行测试，但是相同的 PySimpleGUI 代码_应该_可以在两个版本下工作。这就是为什么当版本 != 2.x 时，该函数返回一个空元组，因为 super() 调用在 v.3.x 下不需要任何参数。

Avatar
Mike Kell | 2018 年 9 月 26 日
还没有读者喜欢这个。

如何添加覆盖应用程序整个窗口的背景图片？我在任何地方都看不到这个功能。只能更改颜色。

主题也无法工作。

sg.ChangeLookAndFeel('BluePurple')
没有任何反应。也尝试更改颜色变量。

Avatar
Mike Barnett | 2018 年 9 月 26 日
还没有读者喜欢这个。

如果您使用的是 Mac，您将看不到任何变化。您将看到打印出此消息
*** Mac 平台不支持更改外观 ***'

请确保在布局定义之前调用 ChangeLookAndFeel。布局需要知道颜色。

您还可以使用您想要的各个颜色选项调用 SetOptions。Mac 没有阻止它的调用。阻止 Look and Feel 调用的原因是按钮颜色在 Mac 上不起作用。

如果问题仍然存在，请随时在 github 上记录一个 issue。

Avatar
Curt Wuollet | 2018 年 10 月 19 日
还没有读者喜欢这个。

有没有办法防止多行输入框爆炸到操作系统
如果用户按下回车键？
Raspbian Raspberry Pi

Avatar
Mike Barnett | 2018 年 10 月 22 日
还没有读者喜欢这个。

因为你没有提到任何崩溃，听起来你的 Read 正常返回，你只是退出了程序。可能发生的情况是您正在使用 Submit() 或 OK() 按钮。默认情况下，这些按钮有一个名为 bind_return_key 的参数设置为 true。如果您正在使用内置按钮，请尝试添加参数 ... bind_return_key=False... 到调用中。或者您可以切换到使用类似 Button("Submit") 的调用来制作自己的按钮。像这样的普通按钮没有像内置按钮那样绑定回车键。如果您有更多问题，请在 github 网站上记录一个 issue (www.PySimpleGUI.com)

相关内容

Creative Commons License本作品根据 Creative Commons Attribution-Share Alike 4.0 International License 许可授权。
© . All rights reserved.