PyQt4 控制元件

單擊此處檢視原文。
部件（widgets）是應用程式的基本構建塊。PyQt4包含廣泛的各種部件，包括按鈕、單選框、滑動塊和列表框等。在本節中，主要介紹PyQt4中幾個常用的部件：QtGui.QCheckBox, ToggleButton, QtGui.QSlider, QtGui.QProgressBar, QtGui.QCalendarWidget。

1 複選框（QtGui.QCheckBox)

#!/usr/bin/python
# -*- coding: utf-8 -*-

import sys
from PyQt4 import QtGui, QtCore

class
 
 Example(QtGui.QWidget):

    def __init__(self):
        super(Example, self).__init__()

        self.initUI()

    def initUI(self):

        cb = QtGui.QCheckBox('Show title', self)
        cb.move(20, 20)
        # 由於我們在後面設定了視窗標題，因此需要選中該複選框。
        cb.toggle()
        # 將自定義的changeTitle()方法與stateChanged訊號關聯。
 

        # changeTitle()方法將會切換視窗標題。
        cb.stateChanged.connect(self.changeTitle)

        self.setGeometry(300, 300, 250, 150)
        self.setWindowTitle('Check Box')
        self.show()

    # 複選框的狀態將通過引數state傳入到changeTitle()方法中。如果
    # 複選框被選中，我們設定視窗的標題；否則，我們將視窗標題設定為空。
    def changeTitle(self, state)
 
:

        if state == QtCore.Qt.Checked:
            self.setWindowTitle('QtGui.QCheckBox')
        else:
            self.setWindowTitle('')


def main():

    app = QtGui.QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

在上面的示例中，我們建立了一個複選框用於切換視窗的標題。

2 開關按鈕（ToggleButton）

開關按鈕是QtGui.QPushButton的一種特殊模式。該按鈕擁有兩種狀態：按下（pressed）和未按下（not pressed）。我們通過點選它，從而在這兩種狀態之間進行切換。在某些情況下，這種功能可以得到很好的應用。

#!/usr/bin/python
# -*- coding: utf-8 -*-

import sys
from PyQt4 import QtGui

class Example(QtGui.QWidget):

    def __init__(self):
        super(Example, self).__init__()

        self.initUI()

    def initUI(self):

        self.col = QtGui.QColor(0, 0, 0)

        # 通過建立QPushButton並呼叫setCheckable()設定為可選擇，
        # 從而建立開關按鈕。
        redb = QtGui.QPushButton('Red', self)
        redb.setCheckable(True)
        redb.move(10, 10)

        # 將按鈕點選訊號與自定義方法關聯。We use the 'clicked'
        # signal that operates with Boolean value.
        # （備註：不太清楚該如何翻譯。）
        redb.clicked[bool].connect(self.setColor)

        greenb = QtGui.QPushButton('Green', self)
        greenb.setCheckable(True)
        greenb.move(10, 60) 

        greenb.clicked[bool].connect(self.setColor)

        blueb = QtGui.QPushButton('Blue', self)
        blueb.setCheckable(True)
        blueb.move(10, 110) 

        blueb.clicked[bool].connect(self.setColor)

        self.square = QtGui.QFrame(self)
        self.square.setGeometry(150, 20, 100, 100)

        self.square.setStyleSheet("QWidget { background-color: %s }" % self.col.name())

        self.setGeometry(300, 300, 280, 170)
        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('QWidget { background-color: %s }' % self.col.name())


def main():

    app = QtGui.QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

在上述的示例中，我們建立了三個開關按鈕和一個QtGui.QWidget，並設定QtGui.QWidget的背景色為黑色。開關按鈕將切換紅、綠、藍的顏色值，背景顏色取決於我們按下的按鈕。

3 滑動塊（QtGui.QSlider）

QtGui.QSlider是擁有一個簡單處理的部件，它可以向前或向後拉動。通過這種方式，我們可以為特定任務選擇一個值。有時，使用滑動塊比讓使用者輸入一個值或是選值框（spin box）更為自然。

#!/usr/bin/python
# -*- coding: utf-8 -*-

import sys
from PyQt4 import QtGui, QtCore

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.setGeometry(30, 40, 100, 30)
        # 將valueChanged訊號與自定義方法關聯。
        sld.valueChanged[int].connect(self.changeValue)

        self.label = QtGui.QLabel(self)
        self.label.setText('mute')
        self.label.setGeometry(160, 40, 80, 30)

        self.setGeometry(300, 300, 280, 170)
        self.setWindowTitle('Slider')
        self.show()

    def changeValue(self, value):

        # 通過滑塊的值，我們可以改變標籤的文字。
        if value == 0:
            self.label.setText('mute')
        elif value > 0 and value <= 30:
            self.label.setText('min')
        elif value > 30 and value < 80:
            self.label.setText('med')
        else:
            self.label.setText('max')


def main():

    app = QtGui.QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

在上面的示例中，我們模擬了一個音量控制（原文中使用的是圖片，在此處我將其改為文字了）。通過拉動滑塊，可以改變標籤上的文字。

4 進度條（QtGui.QProgressBar）

當執行長時間的任務時，進度條可用於展示當前執行的進度。它是基於動畫的，這樣使用者就可以很清楚地知道任務的進展情況。在PyQt4中，QtGui.QProgress提供了水平和垂直兩種進度條工具。程式設計人員可以設定進度條的最小值和最大值，預設分別為0和99。

#!/usr/bin/python
# -*- coding: utf-8 -*-

import sys
from PyQt4 import QtGui, QtCore

class Example(QtGui.QWidget):

    def __init__(self):
        super(Example, self).__init__()

        self.initUI()

    def initUI(self):

        # 建立進度條
        self.pbar = QtGui.QProgressBar(self)
        self.pbar.setGeometry(30, 40, 200, 25)

        self.btn = QtGui.QPushButton('Start', self)
        self.btn.move(40, 80)
        self.btn.clicked.connect(self.doAction)

        # 採用定時器啟用進度條
        self.timer = QtCore.QBasicTimer()
        self.step = 0

        self.setGeometry(300, 300, 280, 170)
        self.setWindowTitle('Progress Bar')
        self.show()

    # 每個QtCore.QObject物件及其子類都有一個timeEvent()的事件處理程式
    # 為了響應定時器，需要重新實現事件處理程式
    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:
            # 通過start()方法啟動定時器，該方法有兩個引數：超時時間
            # 和接收事件的物件
            self.timer.start(100, self)
            self.btn.setText('Stop')


def main():

    app = QtGui.QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

在上述例子中，我們建立了一個水平進度條和一個按鈕，按鈕用於控制進度條的開始和停止。

5 日曆控制元件（QtGui.QCalenderWidget）

QtGui.QCalenderWidget提供了基於月的日曆控制元件。它允許使用者以一種簡單而直觀的方式選擇日期。

#!/usr/bin/python
# -*- coding: utf-8 -*-

import sys
from PyQt4 import QtGui, QtCore

class Example(QtGui.QWidget):

    def __init__(self):
        super(Example, self).__init__()

        self.initUI()

    def initUI(self):

        # 建立日曆控制元件
        cal = QtGui.QCalendarWidget(self)
        cal.setGridVisible(True)
        cal.move(20, 20)
        # 當從日曆控制元件上選擇日期時，clicked[QtCore.QDate]將會
        # 觸發，我們將該訊號與showDate()方法關聯
        cal.clicked[QtCore.QDate].connect(self.showDate)

        self.lbl = QtGui.QLabel(self)
        # 獲取選中的日期，轉換為字串，並在標籤控制元件上顯示
        date = cal.selectedDate()
        self.lbl.setText(date.toString())
        self.lbl.move(200, 240) 

        self.setGeometry(300, 300, 490, 300)
        self.setWindowTitle('Check Box')
        self.show()

    def showDate(self, date):

        self.lbl.setText(date.toString())


def main():

    app = QtGui.QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

上述示例程式中包含一個日曆控制元件和一個標籤控制元件。當前選中的日期將會在標籤控制元件上顯示。