模块概览
QtCore模块包括了核心的非GUI功能,该模块用来对时间、文件、目录、各种数据类型、流、网址、媒体类型、线程或进程进行处理。QtGui模块包括图形化窗口组件和及相关类。包括如按钮、窗体、状态栏、滑块、位图、颜色、字体等等。QtHelp模块包含了用于创建和查看可查找的文档的类。QtNetwork模块包括网络编程的类。这些类可以用来编写TCP/IP和UDP的客户端和服务器。它们使得网络编程更容易和便捷。QtOpenGL模块使用OpenGL库来渲染3D和2D图形。该模块使得Qt GUI库和OpenGL库无缝集成。QtScript模块包含了使PyQt应用程序使用JavaScript解释器编写脚本的类。QtSql模块提供操作数据库的类。QtSvg模块提供了显示SVG文件内容的类。可缩放矢量图形(SVG)是一种用XML描述二维图形和图形应用的语言。QtTest模块包含了对PyQt应用程序进行单元测试的功能。(PyQt没有实现完全的Qt单元测试框架,相反,它假设使用标准的Python单元测试框架来实现模拟用户和GUI进行交互。)QtWebKit模块实现了基于开源浏览器引擎WebKit的浏览器引擎。QtXml包括处理XML文件的类,该模块提供了SAX和DOM API的接口。QtXmlPatterns模块包含的类实现了对XML和自定义数据模型的XQuery和XPath的支持。phonon模块包含的类实现了跨平台的多媒体框架,可以在PyQt应用程序中使用音频和视频内容。QtMultimedia模块提供了低级的多媒体功能,开发人员通常使用phonon模块。QtAssistant模块包含的类允许集成Qt Assistant到PyQt应用程序中,提供在线帮助。QtDesigner模块包含的类允许使用PyQt扩展Qt Designer。Qt模块综合了上面描述的模块中的类到一个单一的模块中。这样做的好处是你不用担心哪个模块包含哪个特定的类,坏处是加载进了整个Qt框架,从而增加了应用程序的内存占用。uic模块包含的类用来处理.ui文件,该文件由Qt Designer创建,用于描述整个或者部分用户界面。它包含的加载.ui文件和直接渲染以及从.ui文件生成Python代码为以后执行的类。

简单的例子
这个例子十分简单,它仅仅现实一个小窗体。但是我们可以在这个窗体上进行很多操作,我们可以调整大小、最大化、最小化。这些需要很多编码,有人已经把这些功能写好了。因为它在所有的应用程序中重复,因此没有必要再写一次,所以它被隐藏了起来。PyQt是一个高级的工具包。如果我们在一个低级的工具包下写代码,那么接下来的例子将很容易的达到几十行。
#!/usr/bin/python
# simple.py
import sys
from PyQt4 import QtGui
app = QtGui.QApplication(sys.argv)
widget = QtGui.QWidget()
widget.resize(, )
widget.setWindowTitle('simple')
widget.show()
sys.exit(app.exec_())上面的代码显示在屏幕上显示一个小窗体。
import sys from PyQt4 import QtGui
我们在这里进行一些必要的import操作。基本的GUI组件在 QtGui 模块中。
app = QtGui.QApplication(sys.argv)
每个PyQt4程序必须创建一个application对象,application在 QtGui 模块中, sys.argv 参数是命令行中的一组参数。Python脚本可以在shell中运行,这样,我们可以控制脚本的启动。否则会出现以下的错误信息:
QWidget: Must construct a QApplication before a QPaintDevice [Finished in 0.8s]
接着
widget = QtGui.QWidget()
QWidget 窗口组件是PyQt4中所有用户界面对象的基类,我们使用 QWidget 默认的构造,没有父亲。没有父亲的窗口组件称为窗体。
widget.resize(, )
resize() 方法调整了 widget 的大小,宽250像素,高150像素。
widget.setWindowTitle('simple')这里我们为窗口设置了标题,标题显示在标题栏上。
widget.show()
show() 方法将窗口呈现在屏幕上。
sys.exit(app.exec_())
最后,我们输入应用程序的主事件循环,事件处理从这里开始。主事件循环从窗口系统接收事件并分发到应用程序的窗口组件上。当主事件循环结束,如果我们调用 exit() 方法或者主窗口组件被销毁。 sys.exit() 方法确保干净的退出。将通知环境应用程序是如何结束的。
你是否想知道为什么 exec_() 方法会有下划线,一切皆有含义,这显然是因为exec是Python的关键字,因此,用 exec_() 来取代它。
运行效果如下:

应用程序图标
应用程序图标是一个小图像,一般显示在标题栏的左上角,在接下来的例子中,我们将会展示如何在PyQt中实现。我们也会介绍一些新方法。
注解:在Mac OS X和Ubuntu中,图标不会显示在标题栏上,因此下面使用的是Windows XP下的截图。
import sys
from PyQt4 import QtGui
class Icon(QtGui.QWidget):
"""docstring for Icon"""
def __init__(self, parent=None):
QtGui.QWidget.__init__(self, parent)
self.setGeometry(, , , )
self.setWindowTitle('Icon')
self.setWindowIcon(QtGui.QIcon('pic/1.png'))
if __name__ == '__main__':
app = QtGui.QApplication(sys.argv)
icon = Icon()
icon.show()
sys.exit(app.exec_())上一个例子用面向过程的方式编写。Python语言支持面向过程和面向对象编程。在PyQt4中编程意味着OOP编程。
class Icon(QtGui.QWidget):
def __init__(self, parent=None):
QtGui.QWidget.__init__(self, parent)在面向对象编程中三个最重要东西是类、数据和方法。这里我们创建一个名为 Icon 的新类,继承自 QtGui.QWidget 类,意味着我们必须调用两个构造方法,第一个为 Icon 类,第二个为继承的父类。
self.setGeometry(, , , )
self.setWindowTitle('Icon')
self.setWindowIcon(QtGui.QIcon('pic/1.png'))所有这三个类,均继承自 QtGui.QWidget , setGeometry() 方法干了两件事,它定义了窗体在屏幕上的位置,并设置窗体的大小。开始的两个参数是窗体的x和y的位置,第三个是宽度,第四个是高度。最后一个方法设置了应用程序图标。通过这个,我们创建了一个 QIcon 对象, QIcon 接受我们想要显示的图标的路径。
运行效果如下:

显示工具提示
我们可以为任何组件提供气泡帮助。
#!/usr/bin/python
# tooltip.py
import sys
from PyQt4 import QtGui
from PyQt4 import QtCore
class Tooltip(QtGui.QWidget):
def __init__(self, parent=None):
QtGui.QWidget.__init__(self, parent)
self.setGeometry(, , , )
self.setWindowTitle('Tooltip')
self.setToolTip('This is a <b>QWidget</b> widget')
QtGui.QToolTip.setFont(QtGui.QFont('OldEnglish', ))
app = QtGui.QApplication(sys.argv)
tooltip = Tooltip()
tooltip.show()
sys.exit(app.exec_())在这个例子中,我们为一个 QWidget 窗口组件显示提示。
self.setToolTip('This is a <b>QWidget</b> widget')通过调用 setTooltip() 方法来创建提示,我们使用富文本格式。
QtGui.QToolTip.setFont(QtGui.QFont('OldEnglish', ))因为默认的 QToolTip 字体太难看,我们改变了它。
运行效果如下:

信号和槽机制
关闭一个窗体很明显的方式是点击标题栏上的x标记,在接下来的例子中,我们将展示如何用编程的方式关闭窗体,我们将简略的接触到信号和槽。
接下来是构造一个 QPushButton ,我们将用在例子中。
QPushButton(string text, QWidget parent = None)
参数 text 是显示在按钮上的文本, parent 是放置按钮的父亲,在这里是 QWidget 。
# encoding:utf-8
# quitbutton.py
import sys
from PyQt4 import QtGui, QtCore
class QuitButton(QtGui.QWidget):
def __init__(self, parent=None):
QtGui.QWidget.__init__(self, parent)
self.setGeometry(300, 300, 250, 150)
self.setWindowTitle('Quit button')
quit = QtGui.QPushButton('Close', self)
quit.setGeometry(10, 10, 64, 35)
self.connect(quit, QtCore.SIGNAL('clicked()'), QtGui.qApp, QtCore.SLOT('quit()'))
if __name__ == '__main__':
app = QtGui.QApplication(sys.argv)
qb = QuitButton()
qb.show()
sys.exit(app.exec_())quit = QtGui.QPushButton('Close', self)
quit.setGeometry(10, 10, 60, 35)创建一个按钮并放置在 QWidget 上,就像把 QWidget 放置在屏幕上一样。
self.connect(quit, QtCore.SIGNAL('clicked()'),
QtGui.qApp, QtCore.SLOT('quit()'))PyQt4中的事件处理系统是建立信号和槽机制。如果点击按钮,信号 clicked() 将会发射,槽可以是PyQt的槽或者任何的Python调用。 QtCore.QObject.connect() 把信号和槽连接起来。在这个例子中槽是PyQt预定义的 quit()槽,发射方和接收方两个对象间进行通讯,发射方为按钮,接收方为application对象。
运行效果如下:

屏幕居中显示窗体
下面的脚本我们将展示如何在屏幕中央显示窗体。
# encoding:utf-8
# center.py
from __future__ import division
import sys
from PyQt4 import QtGui
class Center(QtGui.QWidget):
def __init__(self, parent=None):
QtGui.QWidget.__init__(self, parent)
self.setWindowTitle('center')
self.resize(, )
self.center()
def center(self):
screen = QtGui.QDesktopWidget().screenGeometry()
size = self.geometry()
self.move((screen.width() - size.width()) / ,
(screen.height() - size.height()) / )
if __name__ == '__main__':
app = QtGui.QApplication(sys.argv)
qb = Center()
qb.show()
sys.exit(app.exec_())self.resize(, )
调整这个 QWidget 的大小为250像素宽和150像素高。
screen = QtGui.QDesktopWidget().screenGeometry()
计算屏幕分辨率。
size = self.geometry()
获得 QWidget 的尺寸。
self.move((screen.width()-size.width())/, (screen.height()-size.height())/)
把窗体移动到屏幕中央。