一、提要
小部件是应用程序的基本构建块。 PyQt5 有各种各样的小部件,包括按钮、复选框、滑块或列表框。在本教程的这一部分,我们将描述几个有用的小部件:QCheckBox、切换模式下的 QPushButton、QSlider、QProgressBar 和 QCalendarWidget。
二、PyQt5的QCheckBox
QCheckBox 是一个有两种状态的小部件:开和关。它是一个带有标签的盒子。复选框通常用于表示应用程序中可以启用或禁用的功能。
check_box.py
#!/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 方法。如果小部件被选中,我们设置窗口的标题。否则,我们为标题栏设置一个空字符串。
Figure: QCheckBox
三、状态按钮(Toggle button)
切换按钮是特殊模式下的 QPushButton。它是一个有两种状态的按钮:按下和未按下。我们通过单击在这两种状态之间切换。
toggle_button.py
#!/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)
我们将点击信号连接到用户定义的方法。我们使用以布尔值操作的点击信号。
source = self.sender()
我们得到了被切换的按钮。
if source.text() == "Red": self.col.setRed(val)
如果它是红色按钮,我们会相应地更新颜色的红色部分。
self.square.setStyleSheet("QFrame { background-color: %s }" % self.col.name())
我们使用样式表来改变背景颜色。样式表使用 setStyleSheet 方法更新。
四、划尺 QSlider
QSlider 是一个具有简单句柄的小部件。这个把手可以来回拉动。通过这种方式,我们为特定任务选择了一个值。有时使用滑块比输入数字或使用旋转框更自然。 在我们的示例中,我们展示了一个滑块和一个标签。标签显示图像。滑块控制标签。
slider.py
#!/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 图像设置为标签。
五、进度条QProgressBar
进度条是我们处理冗长任务时使用的小部件。它是动画的,以便用户知道任务正在进行中。 QProgressBar 小部件在 PyQt5 工具包中提供水平或垂直进度条。程序员可以设置进度条的最小值和最大值。默认值为 0 和 99。
progressbar.py
#!/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 提供基于月度的日历小部件。它允许用户以简单直观的方式选择日期。
calendar.py
#!/usr/bin/python
"""
ZetCode PyQt5 tutorial
此示例显示了一个 QCalendarWidget 小部件。
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)
The QCalendarWidget
is created.
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。