「生活可以更简单, 欢迎来到我的开源世界」
  1. PyQt5 简单示例
  2. 应用程序图标
  3. 在 PyQt5 中显示工具提示
  4. 关闭窗口
  5. PyQt5 消息框
  6. 屏幕上的居中窗口
PyQt5 中的第一个程序
2020-08-18
」 「

翻译自原文:First programs in PyQt5

翻译时间 2020 年 8 月 18 日

在 PyQt5 教程的这一部分中,我们学习一些基本功能。这些示例显示工具提示和图标、关闭窗口、显示消息框并在桌面上居中显示窗口。

PyQt5 简单示例

这是一个显示小窗口的简单示例,然而,我们可以用这个窗口做很多事,我们可以调整大小,最大化它或最小化它,这需要大量的编码,有人已经编码了此功能。由于在大多数应用程序中重复,因此无需再次编写代码。PyQt5 是一个高级工具包。如果我们在较低级别的工具包中编写代码,下面的代码示例可以很容易地包含数百行。

simple.py

#!/usr/bin/python

import sys
from PyQt5.QtWidgets import QApplication, QWidget


def main():

app = QApplication(sys.argv)

w = QWidget()
w.resize(250, 150)
w.move(300, 300)
w.setWindowTitle('Simple')
w.show()

sys.exit(app.exec_())


if __name__ == '__main__':
main()

上面的代码示例显示屏幕上的一个小窗口。

import sys
from PyQt5.QtWidgets import QApplication, QWidget

在这里,我们提供必要的进口。基本小部件位于PyQt5.QtWidgets模块中。

app = QApplication(sys.argv)

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

w = QWidget()

QWidget部件是 PyQt5 中所有用户界面对象的基类。我们提供 QWidget的默认构造函数。默认构造函数没有父级。没有父级的小部件称为窗口。

w.resize(250, 150)

resize()方法调整小部件的大小。它是250px宽和150px高。

w.move(300, 300)

move()方法将小部件移动到屏幕上的 x=300、y=300 坐标位置。

w.setWindowTitle('Simple')

我们用setWindowTitle()设置窗口的标题。标题显示在标题栏中。

w.show()

show()方法在屏幕上显示小部件。小部件首先在内存中创建,随后在屏幕上显示。

sys.exit(app.exec_())

最后,我们输入应用程序的主循环(mainloop)。事件处理从这一点开始。主循环从窗口系统接收事件,并将它们发送到应用程序部件。如果我们调用exit()方法或主部件被销毁,则主循环结束。sys.exit()方法可确保干净退出。环境将通知如何结束应用程序。

exec_()方法具有下划线,这是因为exec是 Python 关键字,因此使用exec_()

image-20200818204212869

图:Simple

应用程序图标

应用程序图标是一个小图像,通常显示在标题栏的左上角。在下面的示例中,我们将演示如何在 PyQt5 中做到这一点。我们还将介绍一些新的方法。

某些环境不在标题栏中显示图标。我们需要启用它们。如果看不到任何图标,请参阅原文作者在 Stackoverflow 上的答案,了解解决方案。

icon.py

#!/usr/bin/python

import sys
from PyQt5.QtWidgets import QApplication, QWidget
from PyQt5.QtGui import QIcon
from PyQt5.QtCore import QFileInfo


class Example(QWidget):

def __init__(self):
super().__init__()

self.initUI()


def initUI(self):

self.setGeometry(300, 300, 300, 220)
self.setWindowTitle('Icon')
# 设置图标路径:root为程序文件所在绝对路径(win10+vscode使用相对路径不显示)
root = QFileInfo(__file__).absolutePath()
self.setWindowIcon(QIcon(root + '/web.png'))

self.show()


def main():

app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())


if __name__ == '__main__':
main()

前面的示例以过程样式进行编码。Python 编程语言支持过程和面向对象的编程样式。PyQt5 中的编程意味着在 OOP 中编程。

class Example(QWidget):

def __init__(self):
super().__init__()
...

面向对象的编程中的三个重要方面是类、数据和方法。在这里,我们创建一个名为Example的新类,Example类从QWidget类继承。这意味着我们调用两个构造函数:第一个用于Example类,第二个用于被继承类QWidgetsuper()方法返回Example类的父对象,我们调用其构造函数。__init__()方法是Python语言中的构造函数方法。

self.initUI()

GUI 的创建委派给initUI()方法。

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

这三种方法都是从QWidget类继承的:

def main():

app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())

创建应用程序和示例对象。主循环已启动。

image-20200818210910239

图:图标显示

在 PyQt5 中显示工具提示

我们可以为我们的任何部件提供”显示帮助“。

tooltip.py

#!/usr/bin/python

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


def main():

app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())


if __name__ == '__main__':
main()

在此示例中,我们显示两个 PyQt5 小部件的工具提示。

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

此静态方法设置用于呈现工具提示的字体。我们使用 10pt 的 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)

调整按钮的大小和在窗口上的位置。sizeHint()方法为按钮提供了建议的大小。

image-20200818211718893

图:工具提示

关闭窗口

关闭窗口的显示方式是单击标题栏上的✖标记。在下面的示例中,我们将演示如何以编程方式关闭窗口。我们将简要触摸信号和插槽。

以下是我们在示例中使用的QPushButton部件的构造函数。

QPushButton(string text, QWidget parent = None)

text参数是将显示在按钮上的文本。parent是一个部件用来放置我们的按钮,在我们的案例中,这将是一个QWidget。应用程序中的部件呈现层次结构,在此层次结构中,大多数部件都有其父母,没有父母的部件是顶级窗口。

quit_button.py

#!/usr/bin/python

import sys
from PyQt5.QtWidgets import QWidget, QPushButton, QApplication

class Example(QWidget):

def __init__(self):
super().__init__()

self.initUI()


def initUI(self):

qbtn = QPushButton('Quit', self)
qbtn.clicked.connect(QApplication.instance().quit)
qbtn.resize(qbtn.sizeHint())
qbtn.move(50, 50)

self.setGeometry(300, 300, 350, 250)
self.setWindowTitle('Quit button')
self.show()


def main():

app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())


if __name__ == '__main__':
main()

在此示例中,我们创建一个退出按钮。单击该按钮后,应用程序将终止。

qbtn = QPushButton('Quit', self)

我们创建一个按钮,该按钮是QPushButton类的实例。构造函数的第一个参数是按钮的标签。第二个参数是父部件,父部件是Example,它继承自QWidget

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

PyQt5 中的事件处理系统由信号和插槽机制构建。如果我们单击该按钮,clicked信号将发出。插槽可以是 Qt 插槽或任何 Python 可调用。

使用QApplication.instance()检索到的**QCoreApplication**包含主事件循环,它处理并调度所有事件。单击的信号连接到终止应用程序的quit()方法。通信在两个对象之间完成:发送方和接收方,发送方是按钮,接收方是应用程序对象。

image-20200818213015794

图:退出按钮

PyQt5 消息框

默认情况下,如果我们单击标题栏上的 ✖ 按钮,则QWidget关闭,有时我们想要修改此默认行为。例如,如果我们在编辑器中打开了一个文件,我们为此进行了一些更改。我们显示一个消息框来确认操作。

messagebox.py

#!/usr/bin/python

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


def main():
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())


if __name__ == '__main__':
main()

如果我们关闭QWidgetQCloseEvent将生成 。要修改部件行为,我们需要重新实现事件处理程序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()

在这里,我们测试返回值。如果我们单击”是”按钮,我们接受导致关闭小部件和终止应用程序的事件。否则,我们忽略关闭事件。

image-20200818225254940

图:消息框

屏幕上的居中窗口

以下脚本演示了如何在桌面屏幕上居中设置窗口的中心。

center.py

#!/usr/bin/python

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


def main():

app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())


if __name__ == '__main__':
main()

QDesktopWidget类提供有关用户桌面的信息,包括屏幕大小。

self.center()

将窗口居中的代码放置在自定义方法center()中。

qr = self.frameGeometry()

我们得到一个矩形,指定主窗口的几何体。这包括任何窗口框架。

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

我们计算出显示器的屏幕分辨率。从这个分辨率,我们得到中心点。

qr.moveCenter(cp)

我们的矩形已经有它的宽度和高度,现在我们将矩形的中心设置为屏幕的中心,矩形的大小保持不变。

self.move(qr.topLeft())

我们将应用程序窗口的左上角移动到 qr 矩形的左上角,从而将窗口居中在屏幕上。

先取窗口矩形(模型),将矩形居中,再将程序窗口放到矩形中

在 PyQt5 教程的这一部分中,我们在 PyQt5 中创建了简单的代码示例。

<⇧>