PyQt5中的組件（widgets）
組件（widgets）是構建一個應用的基礎模塊。PyQt5有廣泛的各式各樣的組件，包含按鈕，復選按鈕，滑塊條，和列表框。在這個部分的教程中，我們將學習幾種有用的組件：復選按鈕（QCheckBox），切換按鈕（ToggleButton），滑塊條（QSlider），進度條（ProgressBar）和日歷組件（QCalendarWidget）。
復選框（QCheckBox）
復選框組件有兩種狀態：選中和未選中。它是由一個選擇框和一個標簽組成的。一個應用中，復選框是典型的用來代表有效或無效狀態的組件。
#!/usr/bin/python3
# -*- coding: utf-8 -*-
"""
ZetCode PyQt5 tutorial
In this example, a QCheckBox widget
is used to toggle the title of a window.
author: Jan Bodnar
website: zetcode.com
last edited: January 2015
"""
import sys
from PyQt5.QtWidgets import QWidget, QCheckBox, QApplication
from PyQt5.QtCore import Qt
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, 250, 150)
self.setWindowTitle('QCheckBox')
self.show()
def changeTitle(self, state):
if state == Qt.Checked:
self.setWindowTitle('QCheckBox')
else:
self.setWindowTitle('')
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
在我們的例子中，我們創建了一個復選框，用來切換窗口標題。
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('')
復選框組件的狀態會傳入changeTitle()方法的state參數。如果復選框被選中，我們設置窗口標題。否則，我們把窗口標題設置成一個空字符串。
Figure: QCheckBox
切換按鈕
切換按鈕是QPushButton的特殊模式。切換按鈕有兩種狀態：按下和沒有按下。我們可以通過點擊它在兩種狀態之間切換。下面的列子展示了切換按鈕合適出現的情景。
#!/usr/bin/python3
# -*- coding: utf-8 -*-
"""
ZetCode PyQt5 tutorial
In this example, we create three toggle buttons.
They will control the background colour of a
QFrame.
author: Jan Bodnar
website: zetcode.com
last edited: January 2015
"""
import sys
from PyQt5.QtWidgets import (QWidget, QPushButton,
QFrame, QApplication)
from PyQt5.QtGui import QColor
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)
redb = QPushButton('Green', self)
redb.setCheckable(True)
redb.move(10, 60)
redb.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, 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("QFrame { background-color: %s }" %
self.col.name())
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
在我們的例子中，我們創建了三個切換按鈕和一個QWidget組件。我們把QWidget組件的背景顏色設置為黑色。切換按鈕將在紅色，綠色和藍色的RGB值部分進行切換。QWidget組件的背景顏色將取決於哪一個切換按鈕被按下。
self.col = QColor(0, 0, 0)
這里是初始化，讓RGB值為黑色。
redb = QPushButton('Red', self)
redb.setCheckable(True)
redb.move(10, 10)
要創建切換按鈕，就要創建QPushButton，並且調用setCheckable()方法讓它可被選中。
redb.clicked[bool].connect(self.setColor)
我們把clicked信號連接到我們定義的方法上。我們使用clicked信號來操作布爾值。
source = self.sender()
我們獲得發生狀態切換的按鈕。
if source.text() == "Red":
self.col.setRed(val)
在這種情況下，如果發生切換的是red按鈕，我們更新RGB值中的紅色部分的顏色值。
self.square.setStyleSheet("QWidget { background-color: %s }" % self.col.name())
我們使用樣式表來改變背景顏色。
Figure: Toggle button
滑塊條(QSlider)
滑塊條(QSlider)組件有一個簡單的可調節手柄。這個手柄可以前后拖動。我們可以使用這個方式來選擇具體的數值。有時使用滑塊條比直接輸入數字或使用數值選擇框更自然，在我們下面的例子中，我們將顯示一個滑塊條和一個標簽。標簽將會顯示一個圖像。滑塊條將控制標簽。
#!/usr/bin/python3
# -*- coding: utf-8 -*-
"""
ZetCode PyQt5 tutorial
This example shows a QSlider widget.
author: Jan Bodnar
website: zetcode.com
last edited: January 2015
"""
import sys
from PyQt5.QtWidgets import (QWidget, QSlider,
QLabel, QApplication)
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QPixmap
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, 100, 30)
sld.valueChanged[int].connect(self.changeValue)
self.label = QLabel(self)
self.label.setPixmap(QPixmap('mute.png'))
self.label.setGeometry(160, 40, 80, 30)
self.setGeometry(300, 300, 280, 170)
self.setWindowTitle('QSlider')
self.show()
def changeValue(self, value):
if value == 0:
self.label.setPixmap(QPixmap('mute.png'))
elif value > 0 and value <= 30:
self.label.setPixmap(QPixmap('min.png'))
elif value > 30 and value < 80:
self.label.setPixmap(QPixmap('med.png'))
else:
self.label.setPixmap(QPixmap('max.png'))
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
在我們的例子中，我們模擬了一個音量控制器。通過拖動滑塊條的把手，我們可以改變標簽的圖像。
sld = QSlider(Qt.Horizontal, self)
這里我們創建了一個橫向的滑塊條。
self.label = QLabel(self)
self.label.setPixmap(QPixmap('mute.png'))
我們創建了一個標簽組件，並且設置一個初始的無聲圖片。
sld.valueChanged[int].connect(self.changeValue)
我們把valueChanged 信號連接到我們自定義的 changeValue()方法上。
if value == 0:
self.label.setPixmap(QPixmap('mute.png'))
...
這里實現了根據滑塊條的值，我們設置不同的標簽圖片。在上面的代碼中，如果滑塊條的值等於零，我們為標簽設置mute.png圖片。
Figure: QSlider widget
進度條（QProgressBar）
當我們處理耗時長的任務時，我們需要用到進度條組件。它通過動畫的方式讓我們了解任務正在處理中。在PyQt5中，進度條組件提供了橫向和縱向的進度條選擇。程序員可以設置進度條的最大值和最小值。進度條的默認值是0~99。
#!/usr/bin/python3
# -*- coding: utf-8 -*-
"""
ZetCode PyQt5 tutorial
This example shows a QProgressBar widget.
author: Jan Bodnar
website: zetcode.com
last edited: January 2015
"""
import sys
from PyQt5.QtWidgets import (QWidget, QProgressBar,
QPushButton, QApplication)
from PyQt5.QtCore import QBasicTimer
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')
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
在我們的例子中有一個橫向進度條和一個按鈕。按鈕控制滑塊條的開始和停止。
self.pbar = QProgressBar(self)
這是滑塊條類的構造方法。
self.timer = QtCore.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()方法中，我們開始和停止定時器。
Figure: QProgressBar
日歷組件（QCalendarWidget）
QCalendarWidget類提供了一個基於月的日歷組件。它允許用戶通過簡單的直觀的方式選擇日期。
#!/usr/bin/python3
# -*- coding: utf-8 -*-
"""
ZetCode PyQt5 tutorial
This example shows a QCalendarWidget widget.
author: Jan Bodnar
website: zetcode.com
last edited: January 2015
"""
import sys
from PyQt5.QtWidgets import (QWidget, QCalendarWidget,
QLabel, QApplication)
from PyQt5.QtCore import QDate
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
cal = QCalendarWidget(self)
cal.setGridVisible(True)
cal.move(20, 20)
cal.clicked[QDate].connect(self.showDate)
self.lbl = QLabel(self)
date = cal.selectedDate()
self.lbl.setText(date.toString())
self.lbl.move(130, 260)
self.setGeometry(300, 300, 350, 300)
self.setWindowTitle('Calendar')
self.show()
def showDate(self, date):
self.lbl.setText(date.toString())
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
以上的例子展示一個日歷組件和標簽組件。功能是日歷中選擇的日期會顯示在標簽組件中。
cal = QCalendarWidget(self)
創建QCalendarWidget類。
cal.clicked[QDate].connect(self.showDate)
如果我們在組件上選擇了一個日期，clicked[QDate] 信號會被發射。我們把這個信號和自定義的showDate()方法連接。
def showDate(self, date):
self.lbl.setText(date.toString())
我們通過selectedDate()方法檢索被選中的日期。然后我們把選中的日期對象轉化成字符串顯示在標簽組件上。