PyQt5 小部件
翻译时间 2020 年 8 月 19 日
部件是应用程序的基本构建基块。PyQt5 具有多种部件，包括按钮、复选框、滑块或列表框。在本教程的这一部分中，我们将介绍几个有用的小部件：QCheckBox，QPushButton，QSlider，QProgressBar，QCalendarWidget。
PyQt5 QCheckBox
QCheckBox是具有两种状态的小部件：开和关。它是一个带标签的盒子。复选框通常用于表示应用程序中可以启用或禁用的功能。
check_box.py
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(' ')
部件的状态将传递给changeTitle()方法的state变量。如果部件选中，我们将设置窗口的标题。否则，我们将空字符串设置为标题栏。
切换按钮
切换按钮QPushButton是处于特殊模式的。这是一个按钮，有两个状态：按下和未按下。我们通过单击这两种状态在两种状态之间切换。
toggle_button.py
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 QSliider
QSlider是具有简单滑动条的部件。此滑动条可以来回拉。这样，我们为特定任务选择一个值。有时使用滑块比输入数字或使用旋转框更自然。
在我们的示例中，我们显示一个滑块和一个标签。标签显示图像。滑块控制标签。
slider.py
from PyQt5.QtWidgets import (QWidget, QSlider,
QLabel, QApplication)
from PyQt5.QtCore import Qt, QFileInfo
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)
root = QFileInfo(__file__).absolutePath()
self.label.setPixmap(QPixmap(root + '/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.jpg设置为标签。
PyQt5 QProgressBar
进度条是处理冗长任务时使用的部件。它进行动画处理，以便用户知道任务正在进行中。QProgressBar部件在 PyQt5 工具包中提供水平或垂直进度条。程序员可以设置进度条的最小值和最大值。默认值为 0 和 99。
progressbar.py
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提供基于月份的日历部件。它允许用户以简单直观的方式选择日期。
calendar.py
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()方法。
date = cal.selectedDate()
我们可以通过调用selectedDate()方法来检索QCalendarWidget所选定的日期。
def showDate(self, date):
self.lbl.setText(date.toString())
我们将 date 对象转换为字符串，并将其设置为标签部件。
在 PyQt5 教程的这一部分中，我们介绍了几种常见的部件。