ZetCode

PySide 中的自定义部件

最后修改于 2023 年 10 月 18 日

PySide 拥有丰富的各种部件。没有一个工具包可以提供程序员在其应用程序中可能需要的所有部件。工具包通常只提供最常见的部件,如按钮、文本部件、滑块等。如果需要更专业的部件,我们必须自己创建它。

自定义部件是通过使用工具包提供的绘图工具创建的。有两种可能性。程序员可以修改或增强现有的部件。或者他可以从头开始创建一个自定义部件。

刻录部件

这是我们可以在 Nero、K3B 或其他 CD/DVD 刻录软件中看到的部件。我们完全从头开始创建该部件。它基于一个最小的 QtGui.QWidget 部件。

#!/usr/bin/python

"""
ZetCode PySide tutorial 

In this example, we create a custom widget.

author: Jan Bodnar
website: zetcode.com
"""

import sys
from PySide import QtGui, QtCore

class Communicate(QtCore.QObject):
    
    updateBW = QtCore.Signal(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 信号。该参数是滑块的当前值。该值稍后用于计算要绘制的刻录部件的容量。然后重新绘制自定义部件。

The Burning widget
图:刻录部件

在 PySide 教程的这一部分中,我们创建了一个自定义部件。