从Qt到PyQt

Hello World

PyQt与Qt具有极其相似的类族和API，而且不再使用qmake系统和Q_OBJECT宏使得PyQt在没有编译链接时频繁的错误而且代码更加友好。

from PyQt4 import QtCore, QtGui
import sys

if __name__ == '__main__':
	app = QtGui.QApplication(sys.argv);
	mainWindow = QtGui.QMainWindow();
	mainWindow.setWindowTitle('Hello World from PyQt')
	mainWindow.show()
	label = QtGui.QLabel('Hello World', mainWindow)
	label.show()
	sys.exit(app.exec_())

将项目中所有文件均放入工作目录下，使用python或pythonw命令执行入口文件，即可启动PyQt应用。

可视化组件

PyQt的可视化组件依旧以QtGui.QWidget作为基类，与Qt的API非常类似。更多信息参见

PyQt doc

Qt doc

布局使用示例：

from PyQt4 import QtCore, QtGui
import sys

if __name__ == '__main__':
	app = QtGui.QApplication(sys.argv);
	# init Gui
	mainWindow = QtGui.QMainWindow();
	mainWindow.setWindowTitle('Hello World from PyQt')
	button = QtGui.QPushButton('quit',mainWindow)
	# set layout
	mainLayout = QtGui.QVBoxLayout(mainWindow)
	mainLayout.addWidget(button)
	mainWindow.setLayout(mainLayout)
	# show GUI
	mainWindow.show()
	button.show()
	# init Signal-Slot , Run App
	QtCore.QObject.connect(button, QtCore.SIGNAL('clicked()'), app, QtCore.SLOT('quit()'))
	# QtCore.QObject.connect(button, QtCore.SIGNAL('clicked()'), app.quit)
	sys.exit(app.exec_())

使用Qt Designer

Qt Designer 依旧生成.ui后缀名的xml文件保存界面设计，pyuic4工具可以将.ui格式编译为.py格式的Python类。

确保pyuic4命令所目录在path中，执行：pyuic4 firstDesign.ui > ui_firstDesign.py,

可以得到文件 ui_firstDesign.py：

# -*- coding: utf-8 -*-

# Form implementation generated from reading ui file 'firstDesign.ui'
#
# Created by: PyQt4 UI code generator 4.11.4
#
# WARNING! All changes made in this file will be lost!

from PyQt4 import QtCore, QtGui

try:
    _fromUtf8 = QtCore.QString.fromUtf8
except AttributeError:
    def _fromUtf8(s):
        return s

try:
    _encoding = QtGui.QApplication.UnicodeUTF8
    def _translate(context, text, disambig):
        return QtGui.QApplication.translate(context, text, disambig, _encoding)
except AttributeError:
    def _translate(context, text, disambig):
        return QtGui.QApplication.translate(context, text, disambig)

class Ui_MainWindow(object):
    def setupUi(self, MainWindow):
        MainWindow.setObjectName(_fromUtf8("MainWindow"))
        MainWindow.resize(800, 600)
        self.centralwidget = QtGui.QWidget(MainWindow)
        self.centralwidget.setObjectName(_fromUtf8("centralwidget"))
        # ...
		# something has been deleted
        self.statusbar = QtGui.QStatusBar(MainWindow)
        self.statusbar.setObjectName(_fromUtf8("statusbar"))
        MainWindow.setStatusBar(self.statusbar)

        self.retranslateUi(MainWindow)
        QtCore.QMetaObject.connectSlotsByName(MainWindow)

    def retranslateUi(self, MainWindow):
        MainWindow.setWindowTitle(_translate("MainWindow", "MainWindow", None))
        self.pushButton.setText(_translate("MainWindow", "OK", None))

导入ui_firstDesign模块,调用Ui_MainWindow.setupUi()方法建立UI：

#main.pyw
import sys
from PyQt4 import QtCore, QtGui

from ui_firstDesign import Ui_MainWindow

class MyForm(QtGui.QMainWindow):
	def __init__(self, parent = None):
		QtGui.QMainWindow.__init__(self,parent)
		self.ui = Ui_MainWindow()
		self.ui.setupUi(self)

if __name__ == '__main__':
	app = QtGui.QApplication(sys.argv)
	form = MyForm()
	form.show()
	sys.exit(app.exec_())

运行：

使用Python标准库

PyQt包含以下模块：

• QtCore

核心非GUI组件，包括QObject，事件与信号槽，数据流等。

• QtGui

可视化组件与绘图系统。

• QtOpenGL

OpenGL 支持并与QtGui 结合

• QtSvg

提供对可缩放矢量图(SVG)的支持。

• QtNetwork

提供IP,TCP,UDP协议套接字支持，可以开发简单客户端与服务器。

• QtXml

提供DOM与SAX两种xml解析

• QtSql

提供对Sql的支持

与C++不同，Python标准库具有很多方便使用的功能。在使用C++/Qt时作笔者选择使用QString取代std::string，并使用Qt库提供的网络操作，多任务模型，数据库模块等。

在使用PyQt时可以使用标准的Python 网络，多任务和数据库模块。PyQt的QThread具有支持Qt的事件循环，在需要事件驱动机制可以使用，但无法避开GIL造成性能损失。

信号槽与事件

信号槽

PyQt中绝大多数类均继承了QObject类，QtCore.QObject与QtCore提供了一系列方法进行信号槽操作：

• QtCore.pyqtSignal()

用于定义信号对象：signalObj = QtCore.pyqtSignal(*args)

• @QtCore.pyqtSlot()

使用装饰器将一个函数对象装饰为槽函数：

from PyQt4 import QtGui, QtCore

class MainWidget(QtGui.QWidget):
	def __init__():
		pass

	@QtCore.pyqtSlot()
	def onClicked(self):
		QtGui.QMessageBox.information(self, u"Message", u"Get a Signal")

• QtCore.SIGNAL() 与 QtCore.SLOT()

将代表函数签名的字符串转化为信号槽，与Qt中的SIGNAL()和SLOT宏功能相同。

• QObject.connect()

connect具有两种常用方式，即槽可以使用Python函数对象或者@QtCore.pyqtSlot()修饰的PyQt槽。

QtCore.QObject.connect(button, QtCore.SIGNAL('clicked()'), app, QtCore.SLOT('quit()'))

或者：

QtCore.QObject.connect(button, QtCore.SIGNAL('clicked()'), app.quit)

• QObject.emit()

QObject.emit()用于发送信号，与Qt中的emit关键字功能相同。

class MyWidget(QtGui.QWidget):
	def emitSignal(self):
		self.emit(QtCore.SIGNAL('onClicked()'))

或者

class MyWidget(QtGui.QWidget):
	def emitSignal(self):
		self.mySignal = QtCore.pyqtSignal();

emit的可选参数可以发送带参数的信号：

self.emit(QtCore.SIGNAL('myClicked(QString)'), 'hello')

示例：

from PyQt4 import QtCore, QtGui
import sys

class MyButton(QtGui.QPushButton):

    def __init__(self, *args, **kwargs):
		QtGui.QPushButton.__init__(self, *args, **kwargs)
		self.connect(self, QtCore.SIGNAL("clicked()"), self.emitSignal)

    def emitSignal(self):
    	self.emit(QtCore.SIGNAL('myClicked(QString)'), 'hello')

app = QtGui.QApplication(sys.argv);
mainWindow = QtGui.QMainWindow();

@QtCore.pyqtSlot()
def showMsg(sig):
    QtGui.QMessageBox.information(mainWindow, "Msg", "Siganl Received:" + sig)

if __name__ == '__main__':
	#my Signal
	button = MyButton('emit signal',mainWindow)
	mainWindow.connect(button,QtCore.SIGNAL('myClicked(QString)'), showMsg)
	#quit button
	quitButton = QtGui.QPushButton('quit', mainWindow)
	quitButton.move(0,40)
	QtCore.QObject.connect(quitButton, QtCore.SIGNAL('clicked()'), app, QtCore.SLOT('quit()'))
	# Start App
	mainWindow.show()
	button.show()
	sys.exit(app.exec_())

event()事件处理机制

QObject.event()是PyQt中处理处理事件的另一个机制, 继承QObject()的类都可以重写event系列方

系列实现事件处理。

event()方法进行事件分发一般不直接处理事件，类族中event()链式调用可以方便的自定义事件处理。

一个事件将从最末端派生类的event函数开始处理，当一个事件被处理后调用QObject.accept()方法通知Qt结束该事件处理过程；;若该事件未被处理，Qt将会把该事件交由其父类的event函数处理。

bool QOject::isAccepted()函数将返回代表事件是否被处理的逻辑值。

若在事件处理过程中，调用了QObject::ignore()方法，Qt将会终止事件向上递归，即忽略事件直接终止事件处理过程.忽略事件是危险的,尽量不要这么做。

示例，自定义事件处理：

from PyQt4 import QtCore, QtGui
import sys

class MyWidget():
	def event(self,event):
		if(event.type() == QtCore.QEvent.KeyPress):
			if (event.key() == QtCore.Qt.Key_Escape):
				self.emit(QtCore.SIGNAL("escapePressed()"))
				event.accept()
				return True
		return super(MyWidget, self).event(event)

重写键盘事件处理keyReleaseEvent()与绘图paintEvent()等方法可以方便的处理按键或者绘制界面。以及内置的计时系统timerEvent()。

注意必须设置位置参数event：def keyPressEvent(self, event):

示例，[ESC]键退出应用：

# !/usr/bin/python
import sys
from PyQt4 import QtGui, QtCore

class Escape(QtGui.QWidget):
	def __init__(self, parent=None):
		QtGui.QWidget.__init__(self, parent)
		self.setWindowTitle('escape')
		self.resize(250, 150)
		self.connect(self, QtCore.SIGNAL('closeEmitApp()'),
		QtCore.SLOT('close()'))

	def keyPressEvent(self, event):
		if event.key() == QtCore.Qt.Key_Escape:
			self.close()

if __name__ == '__main__':
	app = QtGui.QApplication(sys.argv)
	qb = Escape()
	qb.show()
	sys.exit(app.exec_())

绘图系统

因为不需要Q_PROPERTY所以使用更加方便。

QAnimation示例：

from  PyQt4 import QtCore, QtGui
import sys

if __name__ == '__main__':
    app = QtGui.QApplication(sys.argv)
    mainWindow = QtGui.QMainWindow()
    mainWindow.resize(400, 400)
    mainWindow.show()
    label = QtGui.QLabel('Animated Button', mainWindow)
    label.show()
    # Animation
    animation = QtCore.QPropertyAnimation(label, 'geometry', mainWindow)
    animation.setDuration(10 * 1000)
    animation.setKeyValueAt(0.5, QtCore.QRect(125, 250, 100, 30))
    animation.setEndValue(QtCore.QRect(250, 0, 100, 30))
    animation.start()
    #Run event loop
    sys.exit(app.exec_())

Graphics View示例：

from  PyQt4 import QtCore, QtGui
import sys

if __name__ == '__main__':
    app = QtGui.QApplication(sys.argv)
    mainWindow = QtGui.QMainWindow()
    mainWindow.resize(300, 200)
    mainWindow.show()
    # Graphics View
    scene = QtGui.QGraphicsScene(mainWindow)
    scene.addText('Graphics View Rotate')
    view =QtGui.QGraphicsView(scene,mainWindow)
    view.resize(200,150)
    view.rotate(+45)
    view.show()
    #Run event loop
    sys.exit(app.exec_())