PyQt5教程（一）——第一个PyQt5程序

原文： http://zetcode.com/gui/pyqt5/firstprograms/

在这部分教程中我们将学习PyQt5的一些基本功能

一个简单的例子

这是一个只显示一个小窗口的简单示例。但我们可以对这个窗口进行一些操作，如调整尺寸，最大化或最小化。这需要编写很多代码，但有人已经完成了这个功能。因为它在多种程序中的通用性，所以不再需要重复编码。PyQt5是一个高级工具集。如果我们使用较低级的工具集进行编码，要实现这个功能最少也要上百行代码。

#!/usr/bin/python3
# -*- coding: utf-8 -*-
 
"""
ZetCode PyQt5 tutorial 
In this example, we create a simple
window in PyQt5.
author: Jan Bodnar
website: zetcode.com 
last edited: January 2015
"""
 
import sys
from PyQt5.QtWidgets import QApplication, QWidget
 
 
if __name__ == '__main__':
    
    app = QApplication(sys.argv)
 
    w = QWidget()
    w.resize(250, 150)
    w.move(300, 300)
    w.setWindowTitle('Simple')
    w.show()
    
    sys.exit(app.exec_())

上面的代码会在屏幕上显示一个小窗体。

import sys
from PyQt5.QtWidgets import QApplication, QWidget

在这里我们导入了必要的模块。这些基本控件位于PyQt5.QtWidgets模块中。

app = QApplication(sys.argv)

每个PyQt5应用程序都需要创建一个application对象。sys.argv是从命令行传入的参数列表。Python脚本可以从shell中运行。这是一种控制脚本启动的方式。

w = QWidget()

控件QWidget是QtPy5中所有UI对象的基类。我们调用了QWidget的默认构造器。默认构造器没有parent参数。没有parent的控件称为窗体(window)。

w.resize(250, 150)

resize()方法用于设置控件的尺寸。它宽250px高150px。

w.move(300, 300)

move()方法将控件移动到坐标为x=300, y=300的位置

w.setWindowTitle('Simple')

这里设置了窗体的标题。标题在标题栏中显示。

w.show()

show()方法将控件显示在屏幕上。控件要先在内存中创建，然后在屏幕上显示。

sys.exit(app.exec_())

最后我们进入了application的主循环。事件处理从这里开始。主循环从窗体系统中接收事件，并将事件分发给控件。在调用exit()方法或主控件销毁时主循环会停止。sys.exit()方法确保可以干净地退出。系统可以感知到程序是如何退出的。

注意exec_()方法的下划线。由于exec是python中的关键字，所以使用exec_()。

图标

程序的图标是显示在标题栏左上角的一个小图像。接下来我们将介绍如何用PyQt5实现，这会用到一些新的API。

#!/usr/bin/python3
# -*- coding: utf-8 -*-
 
"""
ZetCode PyQt5 tutorial 
This example shows an icon
in the titlebar of the window.
author: Jan Bodnar
website: zetcode.com 
last edited: January 2015
"""
 
import sys
from PyQt5.QtWidgets import QApplication, QWidget
from PyQt5.QtGui import QIcon
 
 
class Example(QWidget):
    
    def __init__(self):
        super().__init__()
        
        self.initUI()
        
        
    def initUI(self):
        
        self.setGeometry(300, 300, 300, 220)
        self.setWindowTitle('Icon')
        self.setWindowIcon(QIcon('web.png'))        
    
        self.show()
        
        
if __name__ == '__main__':
    
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())  

之前的示例采用了过程式编码风格。Python语言支持过程式与面向对象的编程风格。PyQt5采用了面向对象编程。

class Example(QWidget):
    
    def __init__(self):
        super().__init__()
        ...

在面向对象编程中有三个要素：类，数据与方法。我们创建了一个Example类，它继承自QWidget。这就意味着我们要调用两个构造器：首先是Example类的，然后是被继承的类的。super()方法返回了Example的父对象，并且我们调用了它的构造器。__init__()方法是Python语言中的构造器。

self.initUI()

GUI的创建交给了initUI()方法。

self.setGeometry(300, 300, 300, 220)
self.setWindowTitle('Icon')
self.setWindowIcon(QIcon('web.png'))  

这三个方法继承自QWidget类。setGeometry()设置了控件的位置与尺寸。前两个参数是窗体的x,y坐标，第三个与第四个参数设置了窗体的宽度与高度。实际上它合并了resize()与move()方法。最后一个方法设置了应用的图标。我们需要创建一个QIcon对象，QIcon接受要显示的图标的路径作为参数。

if __name__ == '__main__':
    
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())  

在这里创建了application与example对象，并且启动了主循环。

tooltip(提示框)的显示

我们可以为所有控件添加消息提示框。

#!/usr/bin/python3
# -*- coding: utf-8 -*-
 
"""
ZetCode PyQt5 tutorial 
This example shows a tooltip on 
a window and a button.
author: Jan Bodnar
website: zetcode.com 
last edited: January 2015
"""
 
import sys
from PyQt5.QtWidgets import (QWidget, QToolTip, 
    QPushButton, QApplication)
from PyQt5.QtGui import QFont    
 
 
class Example(QWidget):
    
    def __init__(self):
        super().__init__()
        
        self.initUI()
        
        
    def initUI(self):
        
        QToolTip.setFont(QFont('SansSerif', 10))
        
        self.setToolTip('This is a <b>QWidget</b> widget')
        
        btn = QPushButton('Button', self)
        btn.setToolTip('This is a <b>QPushButton</b> widget')
        btn.resize(btn.sizeHint())
        btn.move(50, 50)       
        
        self.setGeometry(300, 300, 300, 200)
        self.setWindowTitle('Tooltips')    
        self.show()
        
        
if __name__ == '__main__':
    
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

在这个例子中我们为两个PyQt5控件添加了提示消息。

QToolTip.setFont(QFont('SansSerif', 10))

这个静态方法为tooltip设置了10px的Sanserif字体。

self.setToolTip('This is a <b>QWidget</b> widget')

我们调用setToolTip()方法为控件创建提示消息。消息可以使用富文本格式。

btn = QPushButton('Button', self)
btn.setToolTip('This is a <b>QPushButton</b> widget')

这里我们创建了一个PushButton并为它设置了一个富文本提示消息。

btn.resize(btn.sizeHint())
btn.move(50, 50)   

这里设置了button的尺寸，并将其在窗体上移动。sizeHint()方法为控件返回一个推荐的尺寸。

窗体的关闭

关闭窗体最明显的方法是点击标题栏上的x符号。在下面的例子中，我会展示如何通过编程来关闭窗体。这里我们要涉及到简单的signal和slot(信号槽)。

QPushButton(string text, QWidget parent = None)

这是之前用到的QPushButton控件的构造器。其中text参数是将要在按钮上显示的文本，parent表示按钮的父控件，在这个例子中就是QWidget。一个程序的所有控件构成了一个控件树。在这个树上大部分控件都有父控件。没有父控件的控件是顶层窗体。

#!/usr/bin/python3
# -*- coding: utf-8 -*-
 
"""
ZetCode PyQt5 tutorial 
This program creates a quit
button. When we press the button,
the application terminates. 
author: Jan Bodnar
website: zetcode.com 
last edited: January 2015
"""
 
import sys
from PyQt5.QtWidgets import QWidget, QPushButton, QApplication
from PyQt5.QtCore import QCoreApplication
 
 
class Example(QWidget):
    
    def __init__(self):
        super().__init__()
        
        self.initUI()
        
        
    def initUI(self):               
        
        qbtn = QPushButton('Quit', self)
        qbtn.clicked.connect(QCoreApplication.instance().quit)
        qbtn.resize(qbtn.sizeHint())
        qbtn.move(50, 50)       
        
        self.setGeometry(300, 300, 250, 150)
        self.setWindowTitle('Quit button')    
        self.show()
        
        
if __name__ == '__main__':
    
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

在这个示例中我们创建了一个退出按钮。程序会在点击了这个按钮时退出。

from PyQt5.QtCore import QCoreApplication

这里我们我用到QtCore模块中的一个对象。

qbtn = QPushButton('Quit', self)

我们创建了一个PushButton, 它是QPushButton类的实例。构造器的第一个参数是按钮的标签，第二个参数是它的父控件，也就是Example, 由于继承关系Example也是QWidget。

qbtn.clicked.connect(QCoreApplication.instance().quit)

PyQt5中的事件处理系统采用signal&slot(信号槽)机制。当我们点击按钮时会发出clicked信号。slot可以是Qt slot或任何Python的callable对象。QCoreApplication包含了主事件循环；它可以处理并分发事件。instance()方法返回它的当前实例。QCoreApplication是由QApplication创建的。clicked信号连接到可以退出程序的quit()方法。这个过程由两个对象完成：发送者与接收者。发送者是PushButton，接收者是QApplication对象。

MessageBox(对话框)

当我们点击标题栏上的x按钮时默认会关闭QWidget。但有时我们想改变这种默认行为。例如，如果我们在编辑器中打开了一个文件，并且对这个文件做了修改。在关闭前我们希望显示一个对话框让用户进行确认。

#!/usr/bin/python3
# -*- coding: utf-8 -*-
 
"""
ZetCode PyQt5 tutorial 
This program shows a confirmation 
message box when we click on the close
button of the application window. 
author: Jan Bodnar
website: zetcode.com 
last edited: January 2015
"""
 
import sys
from PyQt5.QtWidgets import QWidget, QMessageBox, QApplication
 
 
class Example(QWidget):
    
    def __init__(self):
        super().__init__()
        
        self.initUI()
        
        
    def initUI(self):               
        
        self.setGeometry(300, 300, 250, 150)        
        self.setWindowTitle('Message box')    
        self.show()
        
        
    def closeEvent(self, event):
        
        reply = QMessageBox.question(self, 'Message',
            "Are you sure to quit?", QMessageBox.Yes | 
            QMessageBox.No, QMessageBox.No)
 
        if reply == QMessageBox.Yes:
            event.accept()
        else:
            event.ignore()        
        
        
if __name__ == '__main__':
    
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

在关闭QWidget时会生成QCloseEvent。我们需要重新实现closeEvent()这个事件处理器来改变控件的行为。

reply = QMessageBox.question(self, 'Message',
    "Are you sure to quit?", QMessageBox.Yes | 
    QMessageBox.No, QMessageBox.No)

我们要显示带有两个按钮(Yes和No)的消息对话框。第一个字符串会显示在标题栏，第二个字符串是对话框的消息文本。第三个参数设置了显示在对话框中的按钮。最后那个参数指定了默认的按钮，也就是默认取得键盘焦点的按钮。返回结果保存在reply变量中。

if reply == QtGui.QMessageBox.Yes:
    event.accept()
else:
    event.ignore()  

我们在这里对返回值进行匹配。当点击了Yes按钮时，我们会接受该事件，从而关闭该控件并退出程序；否则就忽略这个关闭事件。

窗体居中

下面的脚本会将窗体置于桌面中心。

#!/usr/bin/python3
# -*- coding: utf-8 -*-
 
"""
ZetCode PyQt5 tutorial 
This program centers a window 
on the screen. 
author: Jan Bodnar
website: zetcode.com 
last edited: January 2015
"""
 
import sys
from PyQt5.QtWidgets import QWidget, QDesktopWidget, QApplication
 
 
class Example(QWidget):
    
    def __init__(self):
        super().__init__()
        
        self.initUI()
        
        
    def initUI(self):               
        
        self.resize(250, 150)
        self.center()
        
        self.setWindowTitle('Center')    
        self.show()
        
        
    def center(self):
        
        qr = self.frameGeometry()
        cp = QDesktopWidget().availableGeometry().center()
        qr.moveCenter(cp)
        self.move(qr.topLeft())
        
        
if __name__ == '__main__':
    
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())  

QtGui.QDesktopWidget提供了关于用户桌面的信息，包括屏幕尺寸。

self.center()

center()方法中包含了窗体居中的代码。

qr = self.frameGeometry()

得到一个指定了主窗体形状的矩形。

cp = QDesktopWidget().availableGeometry().center()

指出显示器的屏幕分辨率并根据分辨率找出屏幕的中心点。

qr.moveCenter(cp)

将矩形移动到屏幕中心，尺寸不变。

self.move(qr.toLeft())

将窗体的左上角移动到矩形qr的左上角，窗体与矩形重合，从而将窗体置于屏幕中心。

在这部分教程中我们学到了一些PyQt5基础