python qt.doc

在Eric4下用PyQt4编写Python的图形界面程序 2008年6月8日转载请注明作者RunningOn本文是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，然后会问你保存到哪。我设定为保存为DlgHello.ui文件。点OK之后就会新建这个文件并自动打开QtDesigner。 3. 设计界面。先修改主对话框的属性。选中对话框，在右侧的属性编辑器中就可以查看/修改对话框的属性。将windowTitle改为Hello, PyQt，将objectName改为DlgHello”，前者是对话框标题，后者在以后生成代码时有用，不建议使用默认值。我们拖动一个Label(在DisplayWidgets分类中)到对话框中，将属性text改为Hello, PyQt，objectName改为lblHello。再拖动两个PushButton(在Buttons分类中)到对话框，分别将属性text改为你好和退出。将属性objectName分别改为btnHello和btnExit。界面大概是这个样子：4. 处理事件。在PyQt4下，事件处理方面的术语为“信号”和“槽”，即signal和slot。事件对应信号signal，而事件的处理函数则为slot槽。PyQt4有一些预定义的slot，我们可以直接用，比如“退出”按钮的slot，其实就是关闭对话框，这个slot已经在PyQt4中有定义了。对于这样的slot，我们不用单独写代码，在QtDesigner中就可以完成。而对于“你好”按钮，我们需要自己写代码。对于这样的slot，我们在QtDesigner中不做任何处理，甚至不做定义。那么在这个例子中，在QtDesigner里我们只处理退出按钮的单击事件。单击“编辑信号/槽”按钮进入信号/槽编辑模式。点中退出按钮并拖动，会出现一个像是电路图中的接地图示一样的东西，如下： 松开鼠标，就会弹出“配置连接”对话框。勾上“显示从QWidget继承的信号和槽”，左侧选择clicked()，右侧选择close()，点确定，就OK了。如果要继续调整对话框外观，点击“编辑窗口部件”按钮返回窗口编辑模式。5. 生成界面代码保存之后关闭QtDesigner，会发现Eric4的ProjectViewer的Forms选项卡中已经多出DlgHello.ui了。右击它选择Compile Form，就能生成Ui_DlgHello.py文件，并自动加入到工程中。在Sources选项卡中可以看到。双击Ui_DlgHello.py可以看它的内容，其实是生成了一个Ui_DlgHello类。Ui_DlgHello.py是可以单独运行的，在Eric4中直接按F2可以运行，看看初步的效果。发现单击退出按钮果然能直接退出程序。不建议手动修改Ui_DlgHello.py，因为每次改动界面并生成代码后会将手动进行的修改给覆盖掉。6. 添加额外的代码。“你好”按钮的单击处理代码还需要手写。在PyQt4中，界面代码与事件代码是分开的，这一点很赞，这样每次改界面就不会影响到事件处理的代码了。而wxPython这一点就做得不好。事件处理要新建一个类并继承DlgHello类，然后在这个新类里写事件处理函数。新建类的工作可以交给Eric4来完成。右键点DlgHello.ui，选择Generate Dialog Code，在弹出的对话框中设定ClassName为DlgHello，同时，在这个对话框中可以选择我们感兴趣的事件，Eric4会一并生成事件处理函数的定义。如下图：点确定之后，DlgHello.py就生成了。打开这个文件，“你好”按钮的事件被定义为： pyqtSignature() def on_btnHello_clicked(self): Slot documentation goes here. # TODO: not implemented yet raise NotImplementedError注意这个pyqtSignature()自动处理了下面定义的槽slot(事件处理函数)与相对应的信号signal(事件)之间的关联，这里是指，单击btnHello按钮，就会自动执行这个函数。slot的命名规则就是”on_对像名_信号名”，如果想添加新的slot，按这个规则来添加函数就行，并且在函数定义语句之前加上pyqtSignature()，不用再重新生成一次DlgHello.py文件。其实另外一种关联signal与slot之间的方法是在运行里绑定，比如按钮对象btnAbout的clicked信号的槽是about_clicked函数，那么在_init_函数中加入这样一句话： PyQt4.QtCore.QObject.connect(self.btnAbout, PyQt4.QtCore.SIGNAL(clicked(), self.about_clicked)那么单击按钮btnAbout时就会执行about_clicked函数。两种方法各有长处。第一种方法简单，第二种方法对于多个signal使用同一个slot时很有效。将on_btnHello_clicked函数改为： pyqtSignature() def on_btnHello_clicked(self): self.lblHello.setText(你好，PyQt4)在文件头部加上：import PyQt4, PyQt4.QtGui, sys再在代码最后加上(与Ui_DlgHello.py末的几乎一样)：if _name_ = _main_: app = PyQt4.QtGui.QApplication(sys.argv) dlg = DlgHello() dlg.show