PyQt5 控件

最后修改于 2023 年 10 月 18 日

控件是应用程序的基本构建块。 PyQt5 拥有一系列各种各样的控件，包括按钮、复选框、滑块或列表框。 在本教程的这一部分中，我们将介绍几个有用的控件：QCheckBox，处于切换模式的 QPushButton，QSlider，QProgressBar 和 QCalendarWidget。

PyQt5 QCheckBox

QCheckBox 是一个具有两种状态的控件：开和关。 它是一个带有标签的框。 复选框通常用于表示应用程序中可以启用或禁用的功能。

#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

In this example, a QCheckBox widget
is used to toggle the title of a window.

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

from PyQt5.QtWidgets import QWidget, QCheckBox, QApplication
from PyQt5.QtCore import Qt
import sys


class Example(QWidget):

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

        self.initUI()

    def initUI(self):

        cb = QCheckBox('Show title', self)
        cb.move(20, 20)
        cb.toggle()
        cb.stateChanged.connect(self.changeTitle)

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

    def changeTitle(self, state):

        if state == Qt.Checked:
            self.setWindowTitle('QCheckBox')
        else:
            self.setWindowTitle(' ')


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


if __name__ == '__main__':
    main()

在我们的示例中，我们创建一个复选框，该复选框将切换窗口标题。

cb = QCheckBox('Show title', self)

这是一个 QCheckBox 构造函数。

cb.toggle()

我们设置了窗口标题，因此我们还选中了复选框。

cb.stateChanged.connect(self.changeTitle)

我们将用户定义的 changeTitle 方法连接到 stateChanged 信号。 changeTitle 方法将切换窗口标题。

def changeTitle(self, state):

    if state == Qt.Checked:
        self.setWindowTitle('QCheckBox')
    else:
        self.setWindowTitle(' ')

小部件的状态在 state 变量中传递给 changeTitle 方法。 如果选中该小部件，我们将设置窗口的标题。 否则，我们将一个空字符串设置为标题栏。

切换按钮

切换按钮是处于特殊模式的 QPushButton。它是一个具有两种状态的按钮：按下和未按下。我们通过单击它在这两种状态之间切换。

#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

In this example, we create three toggle buttons.
They will control the background color of a
QFrame.

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

from PyQt5.QtWidgets import (QWidget, QPushButton,
                             QFrame, QApplication)
from PyQt5.QtGui import QColor
import sys


class Example(QWidget):

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

        self.initUI()

    def initUI(self):

        self.col = QColor(0, 0, 0)

        redb = QPushButton('Red', self)
        redb.setCheckable(True)
        redb.move(10, 10)

        redb.clicked[bool].connect(self.setColor)

        greenb = QPushButton('Green', self)
        greenb.setCheckable(True)
        greenb.move(10, 60)

        greenb.clicked[bool].connect(self.setColor)

        blueb = QPushButton('Blue', self)
        blueb.setCheckable(True)
        blueb.move(10, 110)

        blueb.clicked[bool].connect(self.setColor)

        self.square = QFrame(self)
        self.square.setGeometry(150, 20, 100, 100)
        self.square.setStyleSheet("QWidget { background-color: %s }" %
                                  self.col.name())

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

    def setColor(self, pressed):

        source = self.sender()

        if pressed:
            val = 255
        else:
            val = 0

        if source.text() == "Red":
            self.col.setRed(val)
        elif source.text() == "Green":
            self.col.setGreen(val)
        else:
            self.col.setBlue(val)

        self.square.setStyleSheet("QFrame { background-color: %s }" %
                                  self.col.name())


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


if __name__ == '__main__':
    main()

在我们的示例中，我们创建了三个切换按钮和一个 QWidget。我们将 QWidget 的背景颜色设置为黑色。切换按钮将切换颜色值的红色、绿色和蓝色部分。背景颜色取决于按下了哪个切换按钮。

self.col = QColor(0, 0, 0)

这是初始的黑色颜色值。

redb = QPushButton('Red', self)
redb.setCheckable(True)
redb.move(10, 10)

要创建切换按钮，我们创建一个 QPushButton 并通过调用 setCheckable 方法使其可选中。

redb.clicked[bool].connect(self.setColor)

我们将 clicked 信号连接到我们用户定义的方法。 我们使用操作布尔值的 clicked 信号。

source = self.sender()

我们获取被切换的按钮。

if source.text() == "Red":
    self.col.setRed(val)

如果它是红色按钮，我们就相应地更新颜色的红色部分。

self.square.setStyleSheet("QFrame { background-color: %s }" %
    self.col.name())

我们使用样式表来更改背景颜色。 样式表使用 setStyleSheet 方法进行更新。

PyQt5 QSlider

QSlider 是一个具有简单手柄的控件。此手柄可以来回拉动。通过这种方式，我们正在为特定任务选择一个值。有时使用滑块比输入数字或使用微调框更自然。

在我们的示例中，我们显示一个滑块和一个标签。标签显示一个图像。滑块控制标签。

#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

This example shows a QSlider widget.

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

from PyQt5.QtWidgets import (QWidget, QSlider,
                             QLabel, QApplication)
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QPixmap
import sys


class Example(QWidget):

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

        self.initUI()

    def initUI(self):

        sld = QSlider(Qt.Horizontal, self)
        sld.setFocusPolicy(Qt.NoFocus)
        sld.setGeometry(30, 40, 200, 30)
        sld.valueChanged[int].connect(self.changeValue)

        self.label = QLabel(self)
        self.label.setPixmap(QPixmap('mute.png'))
        self.label.setGeometry(250, 40, 80, 30)

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

    def changeValue(self, value):

        if value == 0:

            self.label.setPixmap(QPixmap('mute.png'))
        elif 0 < value <= 30:

            self.label.setPixmap(QPixmap('min.png'))
        elif 30 < value < 80:

            self.label.setPixmap(QPixmap('med.png'))
        else:

            self.label.setPixmap(QPixmap('max.png'))


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


if __name__ == '__main__':
    main()

在我们的示例中，我们模拟了一个音量控制。通过拖动滑块的滑块，我们改变标签上的图像。

sld = QSlider(Qt.Horizontal, self)

在这里，我们创建一个水平 QSlider。

self.label = QLabel(self)
self.label.setPixmap(QPixmap('mute.png'))

我们创建一个 QLabel 部件，并为其设置一个初始的静音图像。

sld.valueChanged[int].connect(self.changeValue)

我们将 valueChanged 信号连接到用户自定义的 changeValue 方法。

if value == 0:
    self.label.setPixmap(QPixmap('mute.png'))
...

根据滑块的值，我们为标签设置一个图像。在上面的代码中，如果滑块的值等于零，我们将 mute.png 图像设置给标签。

PyQt5 QProgressBar

进度条是一个在处理冗长任务时使用的控件。它具有动画效果，以便用户知道任务正在进行中。 QProgressBar 控件在 PyQt5 工具包中提供水平或垂直进度条。程序员可以为进度条设置最小值和最大值。默认值为 0 和 99。

#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

This example shows a QProgressBar widget.

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

from PyQt5.QtWidgets import (QWidget, QProgressBar,
                             QPushButton, QApplication)
from PyQt5.QtCore import QBasicTimer
import sys


class Example(QWidget):

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

        self.initUI()

    def initUI(self):

        self.pbar = QProgressBar(self)
        self.pbar.setGeometry(30, 40, 200, 25)

        self.btn = QPushButton('Start', self)
        self.btn.move(40, 80)
        self.btn.clicked.connect(self.doAction)

        self.timer = QBasicTimer()
        self.step = 0

        self.setGeometry(300, 300, 280, 170)
        self.setWindowTitle('QProgressBar')
        self.show()

    def timerEvent(self, e):

        if self.step >= 100:
            self.timer.stop()
            self.btn.setText('Finished')
            return

        self.step = self.step + 1
        self.pbar.setValue(self.step)

    def doAction(self):

        if self.timer.isActive():
            self.timer.stop()
            self.btn.setText('Start')
        else:
            self.timer.start(100, self)
            self.btn.setText('Stop')


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


if __name__ == '__main__':
    main()

在我们的示例中，我们有一个水平进度条和一个推送按钮。 推送按钮启动和停止进度条。

self.pbar = QProgressBar(self)

这是一个 QProgressBar 构造函数。

self.timer = QBasicTimer()

要激活进度条，我们使用计时器对象。

self.timer.start(100, self)

要启动定时器事件，我们调用其 start 方法。此方法有两个参数：超时时间和将接收事件的对象。

def timerEvent(self, e):

    if self.step >= 100:

        self.timer.stop()
        self.btn.setText('Finished')
        return

    self.step = self.step + 1
    self.pbar.setValue(self.step)

每个 QObject 及其后代都有一个 timerEvent 事件处理程序。为了响应定时器事件，我们重新实现事件处理程序。

def doAction(self):

    if self.timer.isActive():
        self.timer.stop()
        self.btn.setText('Start')

    else:
        self.timer.start(100, self)
        self.btn.setText('Stop')

在 doAction 方法中，我们启动和停止计时器。

PyQt5 QCalendarWidget

QCalendarWidget 提供基于月的日历控件。它允许用户以简单直观的方式选择日期。

#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

This example shows a QCalendarWidget widget.

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

from PyQt5.QtWidgets import (QWidget, QCalendarWidget,
                             QLabel, QApplication, QVBoxLayout)
from PyQt5.QtCore import QDate
import sys


class Example(QWidget):

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

        self.initUI()

    def initUI(self):
        vbox = QVBoxLayout(self)

        cal = QCalendarWidget(self)
        cal.setGridVisible(True)
        cal.clicked[QDate].connect(self.showDate)

        vbox.addWidget(cal)

        self.lbl = QLabel(self)
        date = cal.selectedDate()
        self.lbl.setText(date.toString())

        vbox.addWidget(self.lbl)

        self.setLayout(vbox)

        self.setGeometry(300, 300, 350, 300)
        self.setWindowTitle('Calendar')
        self.show()

    def showDate(self, date):
        self.lbl.setText(date.toString())


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


if __name__ == '__main__':
    main()

该示例有一个日历小部件和一个标签小部件。 当前选择的日期显示在标签小部件中。

cal = QCalendarWidget(self)

创建 QCalendarWidget。

cal.clicked[QDate].connect(self.showDate)

如果我们从控件中选择一个日期，则会发出 clicked[QDate] 信号。 我们将此信号连接到用户定义的 showDate 方法。

def showDate(self, date):

    self.lbl.setText(date.toString())

我们通过调用 selectedDate 方法来检索所选日期。 然后我们将日期对象转换为字符串并将其设置为标签小部件。

在本 PyQt5 教程中，我们介绍了以下控件：QCheckBox，处于切换模式的 QPushButton，QSlider，QProgressBar 和 QCalendarWidget。