PyQt5 中的自定义部件
翻译时间 2020 年 8 月 20 日
PyQt5 有一组丰富的部件。但是，没有任何工具包可以提供程序员在应用程序中可能需要的所有部件。工具包通常只提供最常见的部件，如按钮、文本部件或滑块。如果需要更专业的部件，我们必须自己创建它。
使用工具包提供的绘图工具创建自定义部件。有两个基本的可能性：程序员可以修改或增强现有的部件，或者他可以从头开始创建自定义部件。
PyQt5 刻录小部件
这是一个部件，我们可以在 Nero、K3B 或其他 CD/DVD 刻录软件中看到。
custom_widget.py
from PyQt5.QtWidgets import (QWidget, QSlider, QApplication,
QHBoxLayout, QVBoxLayout)
from PyQt5.QtCore import QObject, Qt, pyqtSignal
from PyQt5.QtGui import QPainter, QFont, QColor, QPen
import sys
class Communicate(QObject):
updateBW = pyqtSignal(int)
class BurningWidget(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
self.setMinimumSize(1, 30)
self.value = 75
self.num = [75, 150, 225, 300, 375, 450, 525, 600, 675]
def setValue(self, value):
self.value = value
def paintEvent(self, e):
qp = QPainter()
qp.begin(self)
self.drawWidget(qp)
qp.end()
def drawWidget(self, qp):
MAX_CAPACITY = 700
OVER_CAPACITY = 750
font = QFont('Serif', 7, QFont.Light)
qp.setFont(font)
size = self.size()
w = size.width()
h = size.height()
step = int(round(w / 10))
till = int(((w / OVER_CAPACITY) * self.value))
full = int(((w / OVER_CAPACITY) * MAX_CAPACITY))
if self.value >= MAX_CAPACITY:
qp.setPen(QColor(255, 255, 255))
qp.setBrush(QColor(255, 255, 184))
qp.drawRect(0, 0, full, h)
qp.setPen(QColor(255, 175, 175))
qp.setBrush(QColor(255, 175, 175))
qp.drawRect(full, 0, till - full, h)
else:
qp.setPen(QColor(255, 255, 255))
qp.setBrush(QColor(255, 255, 184))
qp.drawRect(0, 0, till, h)
pen = QPen(QColor(20, 20, 20), 1,
Qt.SolidLine)
qp.setPen(pen)
qp.setBrush(Qt.NoBrush)
qp.drawRect(0, 0, w - 1, h - 1)
j = 0
for i in range(step, 10 * step, step):
qp.drawLine(i, 0, i, 5)
metrics = qp.fontMetrics()
fw = metrics.width(str(self.num[j]))
x, y = int(i - fw/2), int(h / 2)
qp.drawText(x, y, str(self.num[j]))
j = j + 1
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
OVER_CAPACITY = 750
sld = QSlider(Qt.Horizontal, self)
sld.setFocusPolicy(Qt.NoFocus)
sld.setRange(1, OVER_CAPACITY)
sld.setValue(75)
sld.setGeometry(30, 40, 150, 30)
self.c = Communicate()
self.wid = BurningWidget()
self.c.updateBW[int].connect(self.wid.setValue)
sld.valueChanged[int].connect(self.changeValue)
hbox = QHBoxLayout()
hbox.addWidget(self.wid)
vbox = QVBoxLayout()
vbox.addStretch(1)
vbox.addLayout(hbox)
self.setLayout(vbox)
self.setGeometry(300, 300, 390, 210)
self.setWindowTitle('Burning widget')
self.show()
def changeValue(self, value):
self.c.updateBW.emit(value)
self.wid.repaint()
def main():
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
在我们的示例中，我们有一个QSlider和一个自定义部件。滑块控制自定义部件。此部件以图形方式显示介质的总容量和可用的可用空间。我们自定义部件的最小值为 1，最大值为OVER_CAPACITY。如果我们达到价值MAX_CAPACITY，我们开始以红色绘制。这通常表示过度燃烧。
刻录部件放置在窗口底部。这是通过使用QHBoxLayout和QVBoxLayout实现的。
class BurningWidget(QWidget):
def __init__(self):
super().__init__()
表示燃烧的刻录条部件，它基于QWidget部件。
self.setMinimumSize(1, 30)
我们更改小部件的最小大小（高度）。默认值对我们来说有点小。
font = QFont('Serif', 7, QFont.Light)
qp.setFont(font)
我们使用的字体比默认字体小。这更符合我们的需要。
size = self.size()
w = size.width()
h = size.height()
step = int(round(w / 10))
till = int(((w / OVER_CAPACITY) * self.value))
full = int(((w / OVER_CAPACITY) * MAX_CAPACITY))
我们动态绘制部件。窗口更大，刻录部件更大，反之亦然。这就是为什么我们绘制自定义部件的时候必须计算小部件的大小。till参数确定要绘制的总大小，此值来自滑块部件，它是整个区域的一部分。full参数确定我们开始以红色绘制的点。
实际绘图由三个步骤组成。我们绘制黄色或红色和黄色矩形。然后，我们绘制垂直线，将小部件分成几个部分。最后，我们绘制指示介质容量的数字。
metrics = qp.fontMetrics()
fw = metrics.width(str(self.num[j]))
x, y = int(i - fw/2), int(h / 2)
qp.drawText(x, y, str(self.num[j]))
我们使用字体指标来绘制文本。我们必须知道文本的宽度，以便以垂直线为中心。
def changeValue(self, value):
self.c.updateBW.emit(value)
self.wid.repaint()
当我们移动滑块时，将调用changeValue()该方法。在方法内，我们发送一个带参数的自定义信号updateBW。参数是滑块的当前值，该值稍后用于计算要绘制的刻录小部件的容量，然后重新绘制自定义小部件。
在 PyQt5 教程的这一部分中，我们创建了一个自定义部件。