在这篇PyQt5教程中,咱们能够学习一些PyQt5的基础应用。python
这是一个显示一个小窗口的简单例子。咱们能够作许多这样的窗口。咱们能够调整它的窗口尺寸,最大化或最小化这个窗口。这些需求须要码不少代码。但一些人已经写好了这些功能实现。由于这些需求在不少应用中重复出现了,在这里咱们不须要从新写这些代码。PyQt5是一个高级工具套件,为咱们封装了不少复杂功能的实现代码,咱们能够更加简单的经过函数去实现这些功能。若是咱们是在一个低级工具套件中写代码的话,下面例子的代码颇有可能须要数百行来实现。web
1 #!/usr/bin/python3 2 # -*- coding: utf-8 -*- 3 4 """ 5 ZetCode PyQt5 教程 6 在这个例子中, 咱们用PyQt5建立了一个简单的窗口。 7 8 做者: Jan Bodnar 9 网站: zetcode.com 10 最后一次编辑: January 2015 11 """ 12 13 import sys 14 from PyQt5.QtWidgets import QApplication, QWidget 15 16 17 if __name__ == '__main__': 18 19 app = QApplication(sys.argv) 20 21 w = QWidget() 22 w.resize(250, 150) 23 w.move(300, 300) 24 w.setWindowTitle('Simple') 25 w.show() 26 27 sys.exit(app.exec_())
上面的代码示例会在屏幕上显示一个小窗口。shell
import sys from PyQt5.QtWidgets import QApplication, QWidget
这里咱们进行了一些必要模块的导入。最基础的widget组件位于PyQt5.QtWidget模块中编程
app = QApplication(sys.argv)
全部的PyQt5应用必须建立一个应用(Application)对象。sys.argv参数是一个来自命令行的参数列表。Python脚本能够在shell中运行。这是咱们用来控制咱们应用启动的一种方法。数组
w = QWidget()
Qwidget组件是PyQt5中全部用户界面类的基础类。咱们给QWidget提供了默认的构造方法。默认构造方法没有父类。没有父类的widget组件将被做为窗口使用。app
w.resize(250, 150)
resize()方法调整了widget组件的大小。它如今是250px宽,150px高。框架
w.move(300, 300)
move()方法移动widget组件到一个位置,这个位置是屏幕上x=300,y=300的坐标。编程语言
w.setWindowTitle('Simple')
这里咱们设置了咱们窗口的标题。这个标题显示在标题栏中。编辑器
w.show()
show()方法在屏幕上显示出widget。一个widget对象在这里第一次被在内存中建立,而且以后在屏幕上显示。函数
sys.exit(app.exec_())
最后,应用进入主循环。在这个地方,事件处理开始执行。主循环用于接收来自窗口触发的事件,而且转发他们到widget应用上处理。若是咱们调用exit()方法或主widget组件被销毁,主循环将退出。sys.exit()方法确保一个不留垃圾的退出。系统环境将会被通知应用是怎样被结束的。
exec_()方法有一个下划线。由于exec是Python保留关键字。所以,用exec_()来代替。
Figure: Simple
应用图标是一个经常显示在标题栏左上方角落的小图片。在下面的例子里,咱们将展现咱们如何在PyQt5中显示应用图标。咱们也将介绍一些新方法的使用。
#!/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。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'))
三个方法都继承自QWidgets类。setGeometry()作了两件事:将窗口在屏幕上显示,并设置了它的尺寸。setGeometry()方法的前两个参数定位了窗口的x轴和y轴位置。第三个参数是定义窗口的宽度,第四个参数是定义窗口的高度。事实上,这是将resize()和move()方法融合在一个方法内。为了作好这个例子,咱们建立了一个QIcon对象。QIcon对象接收一个咱们要显示的图片路径做为参数。
if __name__ == '__main__': app = QApplication(sys.argv) ex = Example() sys.exit(app.exec_())
应用和example对象被建立。主循环被启动。
Figure: Icon
咱们能够给咱们的任何widget组件提供气泡帮助提示框。
#!/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))
这个静态方法设置了用于提示框的字体。咱们使用10px大小的SansSerif字体。
self.setToolTip('This is a <b>QWidget</b> widget')
为了建立提示框,咱们调用了setTooltip()方法。咱们能够在提示框中使用富文本格式。
btn = QPushButton('Button', self) btn.setToolTip('This is a <b>QPushButton</b> widget')
咱们建立了一个按钮组件而且为它设置一个提示框。
btn.resize(btn.sizeHint()) btn.move(50, 50)
这里改变了按钮的大小,并移动了在窗口上的位置。setHint()方法给了按钮一个推荐的大小。
Figure: Tooltips
明显的关闭窗口的方法是点击标题栏的X标记。在下面的例子中,咱们将展现怎么经过程序来关闭咱们的窗口。咱们将简单的触及信号和槽机制。
QPushButton(string text, QWidget parent = None)
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)
咱们建立了一个按钮。按钮是一个QPushButton类的实例。构造方法的第一个参数是显示在button上的标签文本。第二个参数是父组件。父组件是Example组件,它继承了QWiget类。
qbtn.clicked.connect(QCoreApplication.instance().quit)
在PyQt5中,事件处理系统由信号&槽机制创建。若是咱们点击了按钮,信号clicked被发送。槽能够是Qt内置的槽或Python 的一个方法调用。QCoreApplication类包含了主事件循环;它处理和转发全部事件。instance()方法给咱们返回一个实例化对象。注意QCoreAppli类由QApplication建立。点击信号链接到quit()方法,将结束应用。事件通讯在两个对象之间进行:发送者和接受者。发送者是按钮,接受者是应用对象。
Figure: Quit button
默认的,若是咱们点击了标题栏上的x按钮,QWidget会被关闭。又是咱们但愿修改这个默认动做。举个例子,若是咱们有个文件在编辑器内打开,而且咱们对这个文件作了一些修改。 咱们显示一个message box来确认这个动做。
#!/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)
咱们现实一个带两个按钮的message box:YES和No按钮。代码中第一个字符串的内容被显示在标题栏上。第二个字符串是对话框上显示的文本。第三个参数指定了显示在对话框上的按钮集合。最后一个参数是默认选中的按钮。这个按钮一开始就得到焦点。返回值被储存在reply变量中。
if reply == QtGui.QMessageBox.Yes: event.accept() else: event.ignore()
在这里咱们测试一下返回值。代码逻辑是若是咱们点击Yes按钮,咱们接收到的事件关闭事件,这将致使了组件的关闭和应用的结束。不然不是点击Yes按钮的话咱们将忽略将关闭事件。
Figure: Message box
下面的脚本展现咱们如何把窗口居中显示到桌面窗口。
#!/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.topLeft())