ZetCode

PyQt5 的第一个程序

最后修改于 2023 年 10 月 18 日

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

PyQt5 简单示例

这是一个简单的示例，展示了一个小窗口。但我们仍然可以对这个窗口做很多事情。我们可以调整它的大小、最大化或最小化它。这需要大量的编码。已经有人编写了此功能。由于它在大多数应用程序中都会重复出现，因此无需再次编写它。PyQt5 是一个高级工具包。如果我们在较低级别的工具包中进行编码，则以下代码示例很容易就有数百行。

simple.py 
#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

In this example, we create a simple
window in PyQt5.

Author: Jan Bodnar
Website: zetcode.com
"""

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

最后，我们进入应用程序的主循环。 事件处理从这一点开始。 主循环从窗口系统接收事件，并将它们分派给应用程序小部件。 如果我们调用 exit 方法或主小部件被销毁，主循环将结束。 sys.exit 方法确保干净地退出。 环境将获悉应用程序的结束方式。

exec_ 方法带有一个下划线。 这是因为 exec 是一个 Python 关键字。 因此，使用了 exec_。

Simple
图：简单

应用程序图标

应用程序图标是一个小图像，通常显示在标题栏的左上角。 在下面的示例中，我们展示了如何在 PyQt5 中执行此操作。 我们还介绍了一些新方法。

某些环境不会在标题栏中显示图标。 我们需要启用它们。 如果您没有看到图标，请参阅我在 Stackoverflow 上的 答案 以获得解决方案。

icon.py 
#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

This example shows an icon
in the titlebar of the window.

Author: Jan Bodnar
Website: zetcode.com
"""

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


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 类，第二个用于继承类。 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 接收要显示的图标的路径。

def main():

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

创建了应用程序和示例对象。 主循环开始。

Icon
图：图标

在 PyQt5 中显示工具提示

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

tooltip.py 
#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

This example shows a tooltip on
a window and a button.

Author: Jan Bodnar
Website: zetcode.com
"""

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 方法给出了按钮的推荐大小。

Tooltips
图：工具提示

关闭窗口

关闭窗口的明显方法是单击标题栏上的 x 标记。 在下一个示例中，我们将展示如何以编程方式关闭我们的窗口。 我们简要介绍了信号和槽。

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

QPushButton(string text, QWidget parent = None)

text 参数是将显示在按钮上的文本。 parent 是我们放置按钮的小部件。 在我们的例子中，它将是一个 QWidget。 应用程序的小部件形成一个层次结构。 在此层次结构中，大多数小部件都有其父级。 没有父级的小部件是顶级窗口。

quit_button.py 
#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

This program creates a quit
button. When we press the button,
the application terminates.

Author: Jan Bodnar
Website: zetcode.com
"""

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 可调用对象。

QCoreApplication，通过 QApplication.instance 检索，包含主事件循环 — 它处理并分派所有事件。 clicked 信号连接到 quit 方法，该方法终止应用程序。 通信在两个对象之间完成：发送方和接收方。 发送方是按钮，接收方是应用程序对象。

Quit button
图：退出按钮

PyQt5 消息框

默认情况下，如果我们单击标题栏上的 x 按钮，则 QWidget 将被关闭。 有时我们希望修改此默认行为。 例如，如果我们在编辑器中打开了一个文件，对其进行了一些更改。 我们显示一个消息框以确认该操作。

messagebox.py 
#!/usr/bin/python

"""
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
"""

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

如果我们关闭一个 QWidget，则会生成 QCloseEvent。 要修改小部件行为，我们需要重新实现 closeEvent 事件处理程序。

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

我们显示一个消息框，其中包含两个按钮：是和否。 第一个字符串显示在标题栏上。 第二个字符串是对话框显示的消息文本。 第三个参数指定对话框中出现的按钮组合。 最后一个参数是默认按钮。 它是最初具有键盘焦点的按钮。 返回值存储在 reply 变量中。

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

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

Message box
图：消息框

在屏幕上居中窗口

以下脚本显示了如何在桌面屏幕上居中窗口。

center.py 
#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

This program centers a window
on the screen.

Author: Jan Bodnar
Website: zetcode.com
"""

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 中创建了简单的代码示例。