原文:http://zetcode.com/gui/pyqt5/widgets/python
控件是應用程序的基礎構件。PyQt5具備類目普遍的各類控件,包括按鈕、複選框、滑動條、列表框等。在本節教程中,咱們將學習幾個頗有用的控件:QCheckBox、ToggleButton、QSlider、QProgressBar和QCalendarWidget。程序員
QCheckBox(複選框)是有打開和關閉兩種狀態的控件。它是一個帶有勾選框的Label(標籤)。複選框經常使用於表示程序中能夠啓用或禁用的功能。web
#!/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_())
在這個例子中咱們建立了一個能夠切換窗體標題的複選框。app
cb = QCheckBox('Show title', self)
這是QCheckBox
的構造器。ide
cb.toggle()
由於咱們已經設置了窗體的標題,因此須要勾選複選框。窗體標題默認沒有設置,複選框也沒有勾選。學習
cb.stateChanged.connect(self.changeTitle)
咱們將自定義的changeTitle()
方法鏈接到stateChanged
信號。這個方法會切換窗體的標題。動畫
def changeTitle(self, state): if state == Qt.Checked: self.setWindowTitle('QCheckBox') else: self.setWindowTitle('')
複選框的狀態經由state
參數傳入changeTitle()
方法。在勾選複選框時設置窗體標題,取消勾選時就將標題設爲空字符串。ui
ToggleButton是QPushButton的一種特殊模式。它是一個有兩種狀態的按鈕:按下與未按下。經過點擊在這兩種狀態間來回切換。這種功能在某些場景會很實用。this
#!/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) #這裏應該是greenb,原文寫錯了 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_())
代碼中咱們建立了三個ToggleButton與一個QWidget。咱們將QWidget的背景色設爲黑色。ToggleButton會切換顏色值中的紅色、綠色與藍色部分。QWidget的背景顏色依賴於按下的按鈕。3d
self.col = QColor(0, 0, 0)
這是初始黑顏色的值。
redb = QPushButton('Red', self) redb.setCheckable(True) redb.move(10, 10)
咱們建立一個QPushButton並經過其setCheckable()
方法來獲得一個ToggleButton。
redb.clicked[bool].connect(self.setColor)
將clicked
信號鏈接到用戶自定義的方法。咱們經過clicked
信號操做一個布爾值。
source = self.sender()
咱們獲得了按下的按鈕。
if source.text() == "Red": self.col.setRed(val)
若是按下的是red按鈕,咱們要相應地更新顏色中的紅包部分。
self.square.setStyleSheet("QFrame { background-color: %s }" % self.col.name())
咱們使用樣式表來改變背景顏色。
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'))
咱們建立了一個QLabel控件併爲它設置了一個初始音量圖像。
sld.valueChanged[int].connect(self.changeValue)
咱們將valueChanged信號鏈接到自定義的changeValue()方法。
if value == 0: self.label.setPixmap(QPixmap('mute.png')) ...
咱們根據滑動條的值來設置標籤的圖像。在上面的代碼中,當滑動條的值爲0時咱們爲標籤設置mute.png圖像。
當處理長時間任務時咱們會用到進度條。經過它的動畫效果來告知用戶任務的進度。PyQt5中的QProgressBar
控件提供了水平與垂直的進度條。程序員能夠爲進度條設置最大與最小值,默認爲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)
這是QProgressBar的構造器。
self.timer = QtCore.QBasicTimer()
咱們經過定時器(timer)對象來激活進度條。
self.timer.start(100, self)
咱們調用定時器(timer)的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()
方法中啓動/中止定時器。
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()
方法取得用戶選擇的日期,而後將日期對象轉換成字符串並將其設爲標籤的顯示文本。
在這部分教程中,咱們學習了幾個經常使用控件。