模块概览

  • 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代码为以后执行的类。
PyQt4模块概览和第一个程序

简单的例子

这个例子十分简单,它仅仅现实一个小窗体。但是我们可以在这个窗体上进行很多操作,我们可以调整大小、最大化、最小化。这些需要很多编码,有人已经把这些功能写好了。因为它在所有的应用程序中重复,因此没有必要再写一次,所以它被隐藏了起来。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_() 来取代它。

运行效果如下:

PyQt4模块概览和第一个程序

应用程序图标

应用程序图标是一个小图像,一般显示在标题栏的左上角,在接下来的例子中,我们将会展示如何在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 接受我们想要显示的图标的路径。

运行效果如下:

PyQt4模块概览和第一个程序

显示工具提示

我们可以为任何组件提供气泡帮助。

#!/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 字体太难看,我们改变了它。

运行效果如下:

PyQt4模块概览和第一个程序

信号和槽机制

关闭一个窗体很明显的方式是点击标题栏上的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对象。

运行效果如下:

PyQt4模块概览和第一个程序

屏幕居中显示窗体

下面的脚本我们将展示如何在屏幕中央显示窗体。

# 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())/)

把窗体移动到屏幕中央。