wxPython GUI开发基础实践——Hello world!

参考:
wxPython官方文档
wxPython官方示例demo下载
注:这些示例demo非常有助于入门学习,短小精悍,可快速上手。

有时候在用Python做一些小功能、小工具的时候,希望能封装成GUI桌面程序,方便自己和别人使用。Python有一个内置GUI库tkinter,还有wxPythonpyQt等第三方GUI库,经过多方对比,最终决定使用wxPthon这样一个库来开发自己的GUI小程序。

当然你也可以选择使用Python的Web框架来开发B/S模式的GUI程序,但那就是另外一些技术栈了,适用于写功能比较复杂的程序。而像做一些小工具这样的程序,用wxPython这样的GUI库足矣,开发起来快速、打包便捷。

安装

  • 安装wxPython库:pip install wxpython
  • 在代码中导入wxPython库:import wx

Hello World程序

下面写一个Hello World程序:

# coding:utf-8
# wxPython hello world程序
import wx
import sys
reload(sys)
sys.setdefaultencoding('utf-8')

def main():
    # 1. 创建程序对象
    app = wx.App()
    
    # 2. 创建Frame对象
    win = wx.Frame(None,title = 'Hello World',size = (300,200))
    # 3. 在Frame对象上创建Panel面板对象
    panel = wx.Panel(win)
    # 4. 创建显示文本的区域
    text_area = wx.TextCtrl(panel, style=wx.TE_READONLY)
    # 设置文本区域值
    text_area.SetValue('Hello World!')
    # 5. 创建横向容器box
    hbox = wx.BoxSizer()
    # 6. 把文本区域放到hbox中
    hbox.Add(text_area, proportion=1, flag=wx.EXPAND | wx.TOP | wx.BOTTOM, border=0)
    # 7. 把hbox放到面板中
    panel.SetSizer(hbox)
    
    # 8. 显示窗口
    win.Show()
    # 9. 程序主循环
    app.MainLoop()
    
if __name__ == '__main__':
    main()

运行上面代码,显示:



通过上面代码,一个Hello world程序就完成了。

一个简单的文本编辑器

下面我们来做一个稍微复杂一点的例子,实现一个简单的文本编辑器,就给它起名为foxpad吧,支持以下几点功能:

  • 打开文本文件
  • 编辑文件内容
  • 保存对文件的修改

上代码(代码中有详细的注释):foxpad.py:

# coding:utf-8
# 用wxPython实现一个最简单的文本编辑器
import wx
import sys
reload(sys)
sys.setdefaultencoding('utf-8')

class Foxpad(object):
    '''
    Foxpad文本编辑器类
    '''
    def __init__(self, size = (700, 500)):
        '''
        初始化窗口
        '''
        self.__size = size
        # 创建Frame窗口对象
        self.__win = wx.Frame(None,title = "Foxpad",size = size)
        # 在窗口对象上创建Panel面板对象
        self.__bkg = wx.Panel(self.__win)
        
        # 创建"打开"按钮,用于打开文件
        self.__openBtn = wx.Button(self.__bkg, label='打开')
        # 给该按钮绑定回调函数:openFile
        self.__openBtn.Bind(wx.EVT_BUTTON, self.openFile)

        # 创建用于显示选择的文件的路径的文本区对象
        self.__filepath_area = wx.TextCtrl(self.__bkg, style=wx.TE_READONLY)
        
        # 创建"保存"按钮,用于保存对文件的修改
        self.__saveBtn = wx.Button(self.__bkg, label='保存')
        # 给该按钮绑定回调函数:saveFile
        self.__saveBtn.Bind(wx.EVT_BUTTON, self.saveFile)
        
        # 创建一个横向box,相当于一个容器
        self.__hbox = wx.BoxSizer()
        # 往横向box中添加打开文件按钮、文件路径文本区、保存文件按钮
        # proportion:控件的横向比例,为0表示自适应大小
        # flag:控件的位置参数、拉伸等属性
        # border:控件的外边距像素值
        self.__hbox.Add(self.__openBtn, proportion=0, flag=wx.LEFT | wx.ALL, border=5)
        self.__hbox.Add(self.__filepath_area, proportion=1, flag=wx.EXPAND | wx.TOP | wx.BOTTOM, border=5)
        self.__hbox.Add(self.__saveBtn, proportion=0, flag=wx.LEFT | wx.ALL, border=5)

        # 创建一个纵向box,相当于一个容器
        self.__vbox = wx.BoxSizer(wx.VERTICAL)
        # 把横向box添加到纵向box中,比例自适应
        self.__vbox.Add(self.__hbox, proportion=0, flag=wx.EXPAND | wx.ALL)
        
        # 创建用于显示文件文本内容的多行文本区对象
        self.__multiline_editor = wx.TextCtrl(self.__bkg, style=wx.TE_MULTILINE)
        # 把多行文本区添加到纵向box中,比例为1,即尽量多占
        self.__vbox.Add(self.__multiline_editor,proportion=1,flag=wx.EXPAND | wx.LEFT | wx.BOTTOM | wx.RIGHT,border=5)

        # 把纵向box放到窗口面板中
        self.__bkg.SetSizer(self.__vbox)
    def show(self):
        '''
        显示窗口
        '''
        # 显示窗口
        self.__win.Show()
    def openFile(self,evt):
        '''
        打开按钮回调函数
        '''
        # 打开系统默认风格的文件选择对话框
        dlg = wx.FileDialog(self.__win,"打开文件","","","All files (*.*)|*.*",wx.FD_OPEN | wx.FD_FILE_MUST_EXIST)
        filepath = ''
        # 当点击了文件选择对话框的确认按钮,给filepath变量赋值为当前选择的文件的路径;如果点击了取消按钮,不做任何操作
        if dlg.ShowModal() == wx.ID_OK:
            filepath = dlg.GetPath()
        else:
            # 当点击了取消按钮或关闭对话框按钮,什么也不做
            return
        # 设置文件路径文本区对象的值为选中的文件路径(绝对路径)
        self.__filepath_area.SetValue(filepath)
        # 打开文件,读取文件内容并显示到多行编辑区中
        with open(filepath,'r') as file:
            fcontent = file.read()
            self.__multiline_editor.SetValue(fcontent)
    def saveFile(self,evt):
        '''
        保存按钮回调函数
        '''
        # 如果当前打开的文件为空,直接返回
        if not self.__filepath_area.GetValue():
            return
        # 获取当前多行编辑区的文本内容
        fcontent = self.__multiline_editor.GetValue()
        # 把当前的文本内容写入文件
        with open(self.__filepath_area.GetValue(),'w+') as file:
            file.write(fcontent)
        # 弹出消息框,提示保存成功,消息框的样式采用"OK_DEFAULT"类型的消息框
        dlg = wx.MessageDialog(None, "保存成功!", "保存修改", wx.OK_DEFAULT)
        # 显示消息框
        dlg.ShowModal()

def main():
    # 创建程序对象
    app = wx.App()
    
    # 创建foxpad对象
    foxpad = Foxpad()
    # 显示窗口
    foxpad.show()
    
    # 程序主循环
    app.MainLoop()
    
if __name__ == '__main__':
    main()

运行上面的代码,弹出一个窗口如下:


点击"打开"按钮,会打开Windows系统默认的文件选择对话框:


选择一个文件,比如test.txt,然后就可以在多行编辑区编辑这个文件的内容:

然后点"保存"按钮,提示保存成功:


把foxpad.py打包成exe可执行程序

完成了foxpad程序的编写之后,如果想把它打包成一个独立的exe文件,可以直接双击就能运行,也可以在没有安装Python和wxPython的电脑上也可以使用,那么是时候用pyinstaller打包一把了(需要提前用pip install pyinstaller命令安装好pyinstaller工具,pyinstaller详细用法参见:python打包工具pyinstaller的用法)。

打开命令行,cd到foxpad.py文件所在的目录,然后执行命令:
pyinstaller -F -w foxpad.py

稍等片刻后,在当前目录下的dist目录下就可以看到foxpad.exe这么一个独立可执行程序了,双击foxpad.exe执行,可以看到和刚刚用python运行foxpad.py同样的效果。

总结

本文写了两个非常简单的小例子来展示wxPython这样一个GUI库的入门用法,旨在对这个库有一个基本的认识。更深入的学习可去看官方文档和官方demo,强烈推荐去看官方提供的demo,有很多简单、实用的现成例子,从实例入手,学习起来更加事半功倍。


源码已经放到:我的GitHub

推荐阅读更多精彩内容