python图形界面开发工具之PySimpleGUI

缘起:

　　工作中使用频次较高的操作都需要登录到某个管理平台上进行选择操作,如果是给别人使用还算可以, 但是作为平常使用还是感觉较为繁琐,于是打算开发一个桌面小工具解决这个痛点,达到使用时及时调起使用,方便而节约时间.

Electron,python,flutter...工具框架很多, 前端不擅长,flutter需要重新了解, 最终多款之后选择基于python的一个工具PySimpleGUI,好处在这里就不说了,可以自行百度

 

 

[开始]

PySimpleGUI是基于Python的图形界面开发工具，相较于Python自带的图形界面开发库Tkinter，第三方图形界面开发工具PyQT、WxPython等，其具有基础要求低、代码量少、修改方便、涵盖内容多等优势。

 需要使用的工具1、Python 3.6 及以上版本2、外部库：

①PySimpleGUI（主要库，基于Python自带的GUI图形设计库Tkinter）

②PySimpleGUIWX（基于GUI图形设计库WxPython）

③PySimpleGUIQT（基于GUI图形设计库PySID2）

④PySimpleGUIWEB（基于GUI网页端图形设计库Remi）

3、第三方编程软件

推荐使用 Sublime Text 或者 PyCharm 两种中的一种软件

[安装]

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pysimplegui pysimpleguiwx pysimpleguiqt pysimpleguiweb

 

示例:

#1) 导入库
import PySimpleGUI as sg
#2) 定义布局，确定行数
layout=[
            [],
            [],
            []
                  ]
#3) 创建窗口
window=sg.Window('Python GUI',layout)
#4) 事件循环
while True:
      event,values=window.read() #窗口的读取，有两个返回值(1.事件  2.值)
      print(event,values)
      if event==None:  #窗口关闭事件
            break
#5) 关闭窗口
window.close()

 

 

 

1、定义窗口关闭事件

窗口关闭按钮是界面右上角的“X”。

定义窗口关闭事件是至关重要的，当你忘记定义窗口关闭事件，然后又点击了窗口右上角的X按钮，它会默默的消耗你100%的CPU。

if event = None:
    break


或者

if event == sg.WIN_CLOSED:
    break

 

2、按钮点击事件

用来判断点击按钮的行为是否发生

3、其他元素事件

像文本元素、输入框、下拉菜单等事件属性默认是关闭的。当手动设置他们的事件属性enable_events = Tnue 时，他们也将具有事件属性。

4、通过列表索引获取返回值

列表是最常用的Python数据类型，它可以存放不同的数据类型（str、int、char等等），用中括号括起来，元素之间用逗号隔开。

5、通过列表获取返回值

界面默认的返回值是通过列表索引获得指定值，但是当给元素设定唯一标识符（key），则该元素无法通过列表索引，只能通过字典key进行索引。（print(values[key])）即将文本元素、输入框、下拉菜单等的定位由数字替换为标识符（key）

如：

import PySimpleGUI as sg
#设置窗口元素
layout = [
    [sg.In('123')],    #设置输入框 0
    [sg.In('456',key='更改了key')],   #设置输入框 1，并修改其识别码“1”为“更改了key”
    [sg.In('789')],       #设置输入框 2
    [sg.Button('确认')]  #设置“确认”按钮
]
windows = sg.Window('test',layout,keep_on_top=True)   #显示窗口
while True:   #设置窗口循环
    event,values = windows.read()   #设置变量作为窗口显示内容
    if event == None :   #设置关闭窗口事件
        break
    if event == '确认':    #设置点击“确认”按钮事件
        print(values['更改了key'])    #设置返回内容
    if event == '确认':    #设置点击“确认”按钮事件
        print(values[1])    #设置返回内容

 在点击“确认”按钮之后，会打印出结果：

 

 

 

********************************************************************************************   自定义主题

 

1、主题内容包含窗口的背景颜色、文本（text）颜色、文本框底色、按钮的字体颜色、按钮颜色等等。

2、查看有效主题

使用代码：

import PySimpleGUI as sg
sg.theme_previewer()

 

 

3、获取所有有效主题值

使用代码

import PySimpleGUI as sg
print(sg.theme_list())

 

 

4、设定主题

①设定指定主题

sg.theme('主题颜色，如Black')

②设定随机主题

sg.theme('')

 

 

5、修改部分主题设置

主题代码	释义
Background	背景色
Text	文本颜色
Input	输入框底色
Scroll	滚轮颜色
Text_Input	输入框文字颜色
Button	按钮颜色（字体颜色，按钮颜色）
Border	边界线宽度
Slide_Depth	滑块宽度

sg.theme_(修改内容，如text)_color(('主题颜色，如Black'))

eg: sg.theme_Text_color

 

******************************************************************************************  自定义窗口内容

1、使用for循环快速自定义窗口

①for 循环前面是个小括号时，从左向右遍历

如：

layout=[
      [[sg.Text(i) for i in "ABCD"]]
        ]

 

 

②for循环前面是个中括号时从上向下遍历

如：

layout=[
     [[sg.Text(i) ]for i in "ABCD"]
       ]

 

 

2、元素之间的组合

 

 ①直接位于一个列表里面

layout=[
      [sg.Text('请输入基本信息')],
      [sg.Text('姓名'),sg.In()],
      [sg.Text('性别'),sg.In()],
      [sg.Text('国籍'),sg.In()],
      [sg.B('确认'),sg.B('取消')]
      ]

 

 

②多个列表结合

layout_1 = [
      [sg.Text('请输入基本信息')],
      [sg.Text('姓名'),sg.In()],
      ]
layout_2 = [
      [sg.Text('性别'), sg.In()],
      [sg.Text('国籍'),sg.In()],
      ]
layout_3 = [
      [sg.B('确认'),sg.B('取消')]
      ]
layout = layout_1 + layout_2 + layout_3

 

 

3、元素间除了用“,”隔开以外，还可以用“]+[”替代。

如：

layout=[
      [sg.Text('请输入基本信息')],
      [[sg.Text('姓名')]+[sg.In()] ]+[
      [sg.Text('性别')]+[sg.In()] ]+[
      [sg.Text('国籍'),sg.In()],
      [sg.B('确认'),sg.B('取消')]]
]

 

 

*************************************************************************** 文本框

 

一、Text元素及内容

元素	内容
text=""	str:要显示的文本。可以包含/n以实现多行。
key=None	[str, int, tuple, object]，元素唯一标识符，书写规范 key='-NMAE-'。用于元素的定位。
size=(None, None)	(int, int): 元素宽度，行高
font=None	设定字体的名称和大小。font='宋体'、font=('宋体',int)或者font=['宋体',int]
auto_size_text=None	bool: 元素根据文本自动调节大小
enable_events=False	bool: 事件属性,设定为True时，点击文本发生事件
relief=None	字体浮雕设计：'raised'、'sunken'、'flat'、'ridge'、'solid'、'groove'
border_width=None	设定relief时，用来设定边界宽度
text_color=None	文本颜色
background_color=None	文本背景颜色
justification=None	对齐方式: 'left'、'right'、'center'
pad=None	元素间隔设定。数字顺序为左右上下。 (int, int)、((int, int),(int,int)) 、(int,(int,int))、 ((int, int),int)或者(left/right, top/bottom)、((left, right), (top, bottom))
right_click_menu=None①	右击调出菜单。List[List[Union[List[str],str]]]。设定后，右击此元素可以调出菜单
grab=False	bool:如果为真,点此元素可以移动拖拽窗口
tooltip=None	str:悬浮文本 ,当光标置于该元素上方,会显示设定的文本
visible=True	bool: 元素可见状态

①右击调出菜单，写法为：

[sg.Text('请输入基本信息',right_click_menu=['0',['1',['1-1','1-2'],'2','3']])]

 

 运行:

 

 

 

二、元素更新

1、更新方法

window[key].update()
window[key].Update()

2、可更新元素

update(
    value=None,            # str 更新文本
    background_color=None,  # str 更新文本背景颜色
    text_color=None,        # str 更新文本颜色
    font=None,            # 更新字体的名称或者大小
    visible=None         # 更新元素的可见状态
)

①更新文本显示：

window[key].update(value='')
#或者
window[key].update('')

 

 

②更新文本背景颜色

window[key].update(background_color='red')

③更新文本颜色

window[key].update(text_color='yellow')

④更新字体名称或者大小

window[key].update(font='黑体')
#或者
window[key].update(font=('',22))

⑤更新元素的是否可见

window[key].update(visible=False)

 

 

 

********************************************************************* 单行输入框

一、单行输入框元素及内容

 

元素	内容
default_text=''	默认值设定,可以为空字符串
key=None	元素的唯一标识符，规范 key='-INPUT-'
size=(None, None)	宽,高
disabled=False	bool：元素禁用，如果为True则禁用，无法输入任何值
password_char=""	密码字符,一般设置为*
justification=None	对齐方式：'r'、'l'、'c'
background_color=None	输入框的颜色
text_color=None	输入框的文本颜色
font=None	输入框字体的名称或者大小设定
tooltip=None	str: 悬浮文本。当光标置于该元素上方时，设置的文本会显示
border_width=None	输入框边界线宽度设定
enable_events=False	bool : 输入框的事件属性。如果设定为True，输入值时会发生一个事件
do_not_clear=True	bool : 输入框内容不被清除。如果为False，一发生事件，该输入框内的值会被清除
focus=False	bool : 设定焦点。如果为真，则光标显示在此输入框
pad=None	元素之间彼此间隔距离，数字顺序为左右上下。(int, int)、((int, int),(int,int))、(int,(int,int))、 ((int, int),int)或者(left/right, top/bottom)、((left, right), (top, bottom))
disabled_readonly_background_color=None	str: 元素禁用时的背景颜色设定
disabled_readonly_text_color=None	str: 元素禁用时的文本颜色设定
right_click_menu=None	右击按钮菜单 List[List[Union[List[str],str]]]，设定后,右击此元素会调出菜单（同文本）
visible=True	元素的可见状态，如果为False、,则界面不显示该元素

 

二、设置元素焦点（即移动光标）

`window[key].SetFocus()`

`window[key].set_focus()`

三、元素更新

`window[key].update()` 

`window[key].Update()`

可更新元素：

update(
    value=None,        # str  : 更新输入框内的文本
    disabled=None,      # bool : 更新元素的禁用状态

                        # 如果为True,输入框变成只读状态,无法写入
    select=None,        # bool: 元素选中
                       # 如果为True,输入框内的文本被全选中
                       # 和focus或者set_focus 一起试着使用吧（先设置焦点）
    visible=None,        # bool : 更新元素的可见状态
    text_color=None,        # str : 更新输入框内的文本颜色
    background_color=None,     # str : 更新输入框的背景颜色
    move_cursor_to="end"        # 光标移动文本的最后
                               # 和value、focus 一起试着使用吧（先设置焦点）
)

 

 

四、SetTooltip方法，用于元素悬浮文本的设定：

`window[key].SetTooltip('')`

`window[key].set_tooltip('')`

 

 

************************************************************** 按钮

一、按钮元素介绍

元素	内容
button_text=""	显示在按钮上的文本
key=None	元素的唯一标识符
tooltip=None	悬浮文本
disabled=False	元素禁用设定，如果为True，点击按钮也无法发生事件
image_filename=None	图片路径，按钮用图片表示。只支持GIFs和PNGs格式，和image_data二选一使用
image_data=None	图片base64格式，按钮用图片显示。和image_filename二选一使用
image_size=(None, None)	按钮图片大小
image_subsample=None	图片大小设定。为2时→原图片的二分之一大小。即2=1/2，3=1/3，4=1/4……
border_width=None	按钮边界线设定
size=(None, None)	按钮尺寸设定
auto_size_button=None	按钮上的文本自动调节
button_color=None	按钮颜色
disabled_button_color=None	按钮元素禁用时显示的按钮颜色
font=None	字体名称，大小设定
bind_return_key=False	绑定回车键。如果设定为True，回车键会使此元素被点击
focus=False	焦点设置
pad=None	和其他元素之间间隔设定
visible=True	元素的可见状态设定.如果为True，元素则不可见

更新内容：

Update(
    text=None,        # 按钮上显示的文本
    button_color=(None, None),        # 按钮颜色
    disabled=None,        # 元素禁用设定
    image_data=None,        # 图片的base64格式
    image_filename=None,        # 图片的路径
    visible=None,        # 元素可见状态设定
    image_subsample=None,        # 元素大小设定
    disabled_button_color=(None, None),        # 元素禁用时显示的文本和按钮颜色
    image_size=None        # 图片尺寸设定
)

 

 

 

************************************************************************************** 列表元素

一、列表元素介绍

元素	内容
Values=""	列表或者元组等
=None	默认选中的值或者列表
key=None	元素的唯一标识符
select_mode=None	选择模式，有效值包含如下4种： ①single，单选，更换时点击选择； ②multiple，可以多选，逐一点击选择； ③browse，单选，鼠标按住也可以更换选择； ④extended，可以多选，鼠标按住也可以扩展选择
enable_events=False	元素的事件属性。如果设定为True，元素列表项目被选中时会发生事件
bind_return_key=False	绑定回车键。如果设定为True，回车键被按下时相当于此元素被点击
size=(None， None)	字符宽度，行高
disabled=False	元素是否禁用
auto_size_text=None	如果为True，元素自动根据内容大小调整
font=None	设置字体名称或者大小
no_scrollbar=False	如果为True，则没有滚动条
background_color=None	背景颜色设定
text_color=None	字体颜色设定
pad=None	元素间隔设定
tooltip=None	悬浮文本
right_click_menu=None	右击调出菜单。List[List[Union[List[str],str]]]。设定后，右击此元素可以调出菜单
visible=True	元素可见状态设定

二、更新方法

window[key].update()

window[key].Update()

可更新元素：

Update(
    values=None,
            # 元祖或者列表，举例如下
            # values=[1,3]
            # values=(1,3)
    disabled=None,
            # bool : 更新元素是否禁用，举例如下
            # disabled=True
            # disabled=False
    set_to_index=None,
            # 高亮显示设定的索引，Union[int， list， tuple]，举例如下
            # set_to_index=1
            # set_to_index=[1，2]
            # set_to_index=(1，2)
            # 注意!单击只是高亮显示，并未选中。双击才是高亮显示+选中。
            # 单击获取值时，不用valuse(key)，而是window[key].get()
    scroll_to_index=None,
            # int : 将设定的索引跳到要显示第一行
    select_mode=None,
            # 更新元素的选择模式，有效值包含如下4种
            # single  ，单选，更换时点击选择
            # multiple  ，可以多选，逐一点击选择
            # browse   ，单选，鼠标按住也可以更换选择
            # extended  ，可以多选，鼠标按住也可以扩展选择
    visible=None
            # bool: 更新元素的可见状态
            # visible=True
            # visible=False
    )

 

 

 

**************************************************************************** 下拉菜单

一、下拉菜单元素介绍

元素	内容
Values = ""	List[Any]或者Tuple[Any] 。显示下拉菜单信息,列表或者元祖
default_value=None	初始值设定，默认选中
key=None	唯一标识符
size=(None, None)	元素宽度，行高
auto_size_text=None	元素根据文本自动调节
background_color=None	背景颜色设定
text_color=None	文本颜色设定
enable_events=False	元素事件属性。如果设定为True，当元素被选中时，会发生一个事件
disabled=False	元素禁用状态设定。设定为True时，元素不能进行选择，也不能输入
pad=None	元素间隔设定
tooltip=None	str: 悬浮文本设定
readonly=False	元素只读属性,只能选择,不能输入内容
font=None	元素字体名称或者大小设定
visible=True	元素可见状态设定

二、更新方法

window[key].update()

window[key].Update()

元素可以更新的属性：

update(
    value=None,           # 更新默认选中的选项①
    values=None,          # 更新显示的所有下拉菜单文本
    set_to_index=None,     # 高亮显示设定的索引的文本
    disabled=None,        # 更新元素的禁用状态
    readonly=None,        # 更新元素是否只读
    font=None,            # 更新元素的字体名称或者大小
    visible=None
)

注意：

当更新value时，即使处于“readonly=True”，即只读状态下，若“Values”内没有，仍然可以更改，但当重新选择后值消失。