PyQt4 中的自定义控件
最后修改于 2023 年 10 月 18 日
PyQt4 提供了丰富的控件集。然而，没有任何工具包能提供程序员在应用程序中可能需要的所有控件。工具包通常只提供最常见的控件，如按钮、文本控件或滑块。如果需要更专业的控件，我们必须自己创建它。
自定义小部件是使用工具包提供的绘图工具创建的。有两种基本可能性：程序员可以修改或增强现有的部件，或者他可以从头开始创建自定义小部件。
刻录部件
这是我们可以在 Nero、K3B 或其他 CD/DVD 烧录软件中看到的小部件。
#!/usr/bin/python
"""
ZetCode PyQt4 tutorial
In this example, we create a custom widget.
author: Jan Bodnar
website: zetcode.com
"""
import sys
from PyQt4 import QtGui, QtCore
class Communicate(QtCore.QObject):
updateBW = QtCore.pyqtSignal(int)
class BurningWidget(QtGui.QWidget):
def __init__(self):
super(BurningWidget, self).__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 = QtGui.QPainter()
qp.begin(self)
self.drawWidget(qp)
qp.end()
def drawWidget(self, qp):
font = QtGui.QFont('Serif', 7, QtGui.QFont.Light)
qp.setFont(font)
size = self.size()
w = size.width()
h = size.height()
step = int(round(w / 10.0))
till = int(((w / 750.0) * self.value))
full = int(((w / 750.0) * 700))
if self.value >= 700:
qp.setPen(QtGui.QColor(255, 255, 255))
qp.setBrush(QtGui.QColor(255, 255, 184))
qp.drawRect(0, 0, full, h)
qp.setPen(QtGui.QColor(255, 175, 175))
qp.setBrush(QtGui.QColor(255, 175, 175))
qp.drawRect(full, 0, till-full, h)
else:
qp.setPen(QtGui.QColor(255, 255, 255))
qp.setBrush(QtGui.QColor(255, 255, 184))
qp.drawRect(0, 0, till, h)
pen = QtGui.QPen(QtGui.QColor(20, 20, 20), 1,
QtCore.Qt.SolidLine)
qp.setPen(pen)
qp.setBrush(QtCore.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]))
qp.drawText(i-fw/2, h/2, str(self.num[j]))
j = j + 1
class Example(QtGui.QWidget):
def __init__(self):
super(Example, self).__init__()
self.initUI()
def initUI(self):
sld = QtGui.QSlider(QtCore.Qt.Horizontal, self)
sld.setFocusPolicy(QtCore.Qt.NoFocus)
sld.setRange(1, 750)
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 = QtGui.QHBoxLayout()
hbox.addWidget(self.wid)
vbox = QtGui.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 = QtGui.QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
在我们的示例中，我们有一个 QtGui.QSlider 和一个自定义控件。滑块控制着自定义控件。该控件以图形方式显示介质的总容量以及可用的空闲空间。我们自定义控件的最小值是 1，最大值是 750。如果我们达到值 700，我们将开始以红色绘制。这通常表示过载。
刻录控件放置在窗口的底部。这是通过使用一个 QtGui.QHBoxLayout 和一个 QtGui.QVBoxLayout 来实现的。
class BurningWidget(QtGui.QWidget):
def __init__(self):
super(BurningWidget, self).__init__()
刻录控件基于 QtGui.QWidget 控件。
self.setMinimumSize(1, 30)
我们更改部件的最小大小（高度）。默认值对我们来说有点小。
font = QtGui.QFont('Serif', 7, QtGui.QFont.Light)
qp.setFont(font)
我们使用比默认字体更小的字体。这更适合我们的需求。
size = self.size() w = size.width() h = size.height() step = int(round(w / 10.0)) till = int(((w / 750.0) * self.value)) full = int(((w / 750.0) * 700))
我们动态绘制控件。窗口越大，刻录控件也越大，反之亦然。这就是为什么我们必须计算绘制自定义控件的目标窗口的大小。till 参数决定了要绘制的总大小。此值来自滑块控件。它是整个区域的一个比例。full 参数确定我们开始以红色绘制的点。请注意使用浮点数运算以获得更高的绘图精度。
实际的绘制包括三个步骤。我们绘制黄色或红色和黄色的矩形。然后，我们绘制将小部件分成几个部分的垂直线。最后，我们绘制指示介质容量的数字。
metrics = qp.fontMetrics() fw = metrics.width(str(self.num[j])) qp.drawText(i-fw/2, h/2, str(self.num[j]))
我们使用字体度量来绘制文本。我们必须知道文本的宽度才能将其居中于垂直线周围。
def changeValue(self, value):
self.c.updateBW.emit(value)
self.wid.repaint()
当我们移动滑块时，会调用 changeValue 方法。在该方法内部，我们发送一个带有参数的自定义 updateBW 信号。参数是滑块的当前值。该值稍后用于计算要绘制的刻录控件的容量。然后，自定义控件会重新绘制。
在 PyQt4 教程的这一部分，我们创建了一个自定义控件。