本文是PyQt4的入门教程。网上能搜到其它教程,但我觉得讲得不是很清楚,希望这篇文章对入门者更加有帮助。
先介绍一下PyQt4。Qt4图形库一经发布就好评不断,它在Python下的绑定PyQt4更是让我眼前一亮,不但漂亮,而且开发程序非常方便。
在我看来,PyQt4最大的改进之一是它不再拘泥与各种布局控件了,也就是说,现在写图形界面程序,和VB一样可以直接拖控件到窗口上并随便改变大小和位置了,不再像以前那样要先放上布局控件,再在布局控件里放其它控件。
对PyQt4的介绍就限于此,我也不准备把它与其它Python图形库进行比较了,因为经验表明这些东西的比较,特别是Qt与Gtk的比较总是会引起不必要的争吵。
IDE我使用Eric4。Eric4本身是用PyQt4写的,在使用Eric4时就能体会到用PyQt4能写出多棒的图形界面程序。Eric4的详细介绍与安装请见我的其它文章。
操作系统是Windows,在Linux下的操作完全一样。
寒喧结束,进入正题。假设我们要用Python写一个图形界面程序,一个对话框,里面两个button一个label。点击其中一个button能改变label的内容,点击另一个button就退出。
1. 新建工程。
打开Eric4,选择菜单Project->New新建一个工程,名字我们取为HelloPyQt,填好各项并选择工程所在文件夹之后点OK,一个新的不含任何文件的工程就建好了。
2. 新建对话框。
在左侧的ProjectViewer中切换到Forms选项卡(左数第二个),右键点空白位置,选New Form,在弹出的对话框中选择Form类型为Dialog,然后会问你保存到哪。我设定为保存为HelloDlg.ui文件。点OK之后就会新建这个文件并自动打开QtDesigner。
3. 设计界面。
先修改主对话框的属性。选中对话框,在右侧的属性编辑器中就可以查看/修改对话框的属性。将windowTitle改为"Hello, PyQt",将objectName改为"HelloDlg”,前者是对话框标题,后者在以后生成代码时有用,不建议使用默认值。
我们拖动一个Label(在DisplayWidgets分类中)到对话框中,将属性text改为"Hello, PyQt",objectName改为helloLabel。
再拖动两个PushButton(在Buttons分类中)到对话框,分别将属性text改为"你好"和"退出"。将属性objectName分别改为helloButton和exitButton。
界面大概是这个样子:
![](https://i-blog.csdnimg.cn/blog_migrate/b2b20b186e9cd2225c27202d8a27c69b.jpeg)
4. 处理事件。
在PyQt4下,事件处理方面的术语为“信号”和“槽”,即signal和slot。事件对应信号signal,而事件的处理函数则为slot槽。
PyQt4有一些预定义的slot,我们可以直接用,比如“退出”按钮的slot,其实就是关闭对话框,这个slot已经在PyQt4中有定义了。对于这样的slot,我们不用单独写代码,在QtDesigner中就可以完成。而对于“你好”按钮,我们需要自己写代码。对于这样的slot,我们在QtDesigner中不做任何处理,甚至不做定义。
那么在这个例子中,在QtDesigner里我们只处理退出按钮的单击事件。
单击“编辑信号/槽”按钮进入信号/槽编辑模式。点中退出按钮并拖动,会出现一个像是电路图中的接地图示一样的东西,如下:
![](http://hiphotos.baidu.com/runningon/pic/item/ed83a6ef93130302fdfa3c06.jpg)
松开鼠标,就会弹出“配置连接”对话框。勾上“显示从QWidget继承的信号和槽”,左侧选择clicked(),右侧选择close(),点确定,就OK了。
如果要继续调整对话框外观,点击“编辑窗口部件”按钮返回窗口编辑模式。
5. 生成界面代码
保存之后关闭QtDesigner,会发现Eric4的ProjectViewer的Forms选项卡中已经多出HelloDlg.ui了。右击它选择Compile Form,就能生成Ui_HelloDlg.py文件,并自动加入到工程中。在Sources选项卡中可以看到。
双击Ui_HelloDlg.py可以看它的内容,其实是生成了一个Ui_HelloDlg类。Ui_HelloDlg.py是可以单独运行的,在Eric4中直接按F2可以运行,看看初步的效果。发现单击退出按钮果然能直接退出程序。
不建议手动修改Ui_HelloDlg.py,因为每次改动界面并生成代码后会将手动进行的修改给覆盖掉。
6. 添加额外的代码。
“你好”按钮的单击处理代码还需要手写。
在PyQt4中,界面代码与事件代码是分开的,这一点很赞,这样每次改界面就不会影响到事件处理的代码了。而wxPython这一点就做得不好。
事件处理要新建一个类并继承HelloDlg类,然后在这个新类里写事件处理函数。新建类的工作可以交给Eric4来完成。右键点HelloDlg.ui,选择Generate Dialog Code,在弹出的对话框中设定ClassName为HelloDlg,同时,在这个对话框中可以选择我们感兴趣的事件,Eric4会一并生成事件处理函数的定义。如下图:
点确定之后,HelloDlg.py就生成了。打开这个文件,“你好”按钮的事件被定义为:
@pyqtSignature("")
def on_helloButton_clicked(self):
"""
Slot documentation goes here.
"""
# TODO: not implemented yet
raise NotImplementedError
注意这个@pyqtSignature("")自动处理了下面定义的槽slot(事件处理函数)与相对应的信号signal(事件)之间的关联,这里是指,单击helloButton按钮,就会自动执行这个函数。slot的命名规则就是“on_对象名_信号名”,如果想添加新的slot,按这个规则来添加函数就行,并且在函数定义语句之前加上@pyqtSignature(""),不用再重新生成一次HelloDlg.py文件。
其实另外一种关联signal与slot之间的方法是在运行里绑定,比如按钮对象aboutButton的clicked信号的槽是about_clicked函数,那么在__init__函数中加入这样一句话:
self.connect(self.btnAbout, PyQt4.QtCore.SIGNAL("clicked()"), self.about_clicked)
那么单击按钮aboutButton时就会执行about_clicked函数。
两种方法各有长处。第一种方法简单,第二种方法对于多个signal使用同一个slot时很有效。
将on_helloButton_clicked函数改为:
@pyqtSignature("")
def on_helloButton_clicked(self):
self.helloLabel.setText("你好,PyQt4")
在文件头部加上:
import PyQt4, PyQt4.QtGui, sys
再在代码最后加上(与Ui_HelloDlg.py末的几乎一样):
if __name__ == "__main__":
app = PyQt4.QtGui.QApplication(sys.argv)
dlg = HelloDlg()
dlg.show()
sys.exit(app.exec_())
这样就OK了。
7. 最后的收尾工作。
按F2运行脚本,发现点击“你好”按钮后helloLable label中的文字是乱码。
解决办法很简单,把代码中的("你好,PyQt4")改为(u"你好,PyQt4")就行了。PyQt4对中文的支持是很好的。代码统一使用utf8编码,能省去很多麻烦。