# PySide 小部件 > 原文： [http://zetcode.com/gui/pysidetutorial/widgets/](http://zetcode.com/gui/pysidetutorial/widgets/) 小部件是應用的基本構建塊。 PySide 編程工具包包含各種小部件。 按鈕，復選框，滑塊，列表框等。程序員完成工作所需的一切。 在本教程的這一部分中，我們將描述幾個有用的小部件。 即`QtGui.QCheckBox`，`ToggleButton`，`QtGui.QSlider`，`QtGui.QProgressBar`和`QtGui.QCalendarWidget`。 ## `QtGui.QCheckBox` `QtGui.QCheckBox`是具有兩種狀態的窗口小部件：打開和關閉。 這是一個帶有標簽的盒子。 復選框通常用于表示應用中可以啟用或禁用而不會影響其他功能的功能。 ```py #!/usr/bin/python # -*- coding: utf-8 -*- """ ZetCode PySide tutorial In this example, a QtGui.QCheckBox widget is used to toggle the title of a window. author: Jan Bodnar website: zetcode.com last edited: August 2011 """ import sys from PySide 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() cb.stateChanged.connect(self.changeTitle) self.setGeometry(300, 300, 250, 150) self.setWindowTitle('QtGui.QCheckBox') self.show() def changeTitle(self, state): if state == QtCore.Qt.Checked: self.setWindowTitle('Checkbox') else: self.setWindowTitle('') def main(): app = QtGui.QApplication(sys.argv) ex = Example() sys.exit(app.exec_()) if __name__ == '__main__': main() ``` 在我們的示例中，我們將創建一個復選框，以切換窗口標題。 ```py cb = QtGui.QCheckBox('Show title', self) ``` 這是`QtGui.QCheckBox`構造器。 ```py cb.toggle() ``` 我們設置了窗口標題，因此我們還必須選中該復選框。 ```py cb.stateChanged.connect(self.changeTitle) ``` 我們將用戶定義的`changeTitle()`方法連接到`stateChanged`信號。 `changeTitle()`方法將切換窗口標題。 ```py def changeTitle(self, state): if state == QtCore.Qt.Checked: self.setWindowTitle('Checkbox') else: self.setWindowTitle('') ``` 我們在狀態變量中接收復選框的狀態。 如果已設置，則設置窗口的標題。 否則，我們使用一個空字符串作為標題。  圖：`QtGui.QCheckBox` ## 開關按鈕 PySide 沒有用于開關按鈕的小部件。 要創建開關按鈕，我們在特殊模式下使用`QtGui.QPushButton`。 開關按鈕是具有兩種狀態的按鈕。 已按下但未按下。 通過單擊可以在這兩種狀態之間切換。 在某些情況下此功能非常合適。 ```py #!/usr/bin/python # -*- coding: utf-8 -*- """ ZetCode PySide tutorial In this example, we create three toggle buttons. They will control the background color of a QtGui.QFrame. author: Jan Bodnar website: zetcode.com last edited: August 2011 """ import sys from PySide import QtGui, QtCore class Example(QtGui.QWidget): def __init__(self): super(Example, self).__init__() self.initUI() def initUI(self): self.col = QtGui.QColor(0, 0, 0) redb = QtGui.QPushButton('Red', self) redb.setCheckable(True) redb.move(10, 10) 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("QFrame { background-color: %s }" % self.col.name()) def main(): app = QtGui.QApplication(sys.argv) ex = Example() sys.exit(app.exec_()) if __name__ == '__main__': main() ``` 在我們的示例中，我們創建了三個 ToggleButtons。 我們還創建了一個`QtGui.QFrame`小部件。 我們將小部件的背景色設置為黑色。 切換按鈕將切換顏色值的紅色，綠色和藍色部分。 背景顏色取決于我們按下的切換按鈕。 ```py self.col = QtGui.QColor(0, 0, 0) ``` 這是初始顏色值。 它是黑色的。 ```py greenb = QtGui.QPushButton('Green', self) greenb.setCheckable(True) ``` 要創建開關按鈕，我們創建一個`QtGui.QPushButton`并通過調用`setCheckable()`方法使其可檢查。 ```py greenb.clicked[bool].connect(self.setColor) ``` 我們將`clicked[bool]`信號連接到用戶定義的方法。 請注意，此信號類型將`bool`參數發送給該方法。 參數值是 true 還是 false，取決于按鈕的狀態，例如是否檢查/切換。 ```py source = self.sender() ``` 我們得到信號的發送者。 這是被切換的按鈕。 ```py if source.text() == "Red": self.col.setRed(val) ``` 如果它是紅色按鈕，我們將相應地更新顏色的紅色部分。 ```py self.square.setStyleSheet("QFrame { background-color: %s }" % self.col.name()) ``` 我們使用樣式表來更改`QtGui.QFrame`小部件的背景顏色。  圖：`ToggleButton` ## `QtGui.QSlider` `QtGui.QSlider`是具有簡單句柄的小部件。 該手柄可以前后拉動。 這樣，我們可以為特定任務選擇一個值。 有時使用滑塊比只提供一個數字或使用旋轉框更為自然。 `QtGui.QLabel`顯示文本或圖像。 在我們的示例中，我們將顯示一個滑塊和一個標簽。 這次，標簽將顯示圖像。 滑塊將控制標簽。 ```py #!/usr/bin/python # -*- coding: utf-8 -*- """ ZetCode PySide tutorial This example shows a QtGui.QSlider widget. author: Jan Bodnar website: zetcode.com last edited: August 2011 """ import sys from PySide 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) sld.valueChanged[int].connect(self.changeValue) self.label = QtGui.QLabel(self) self.label.setPixmap(QtGui.QPixmap('mute.png')) self.label.setGeometry(160, 40, 80, 30) self.setGeometry(300, 300, 280, 170) self.setWindowTitle('QtGui.QSlider') self.show() def changeValue(self, value): if value == 0: self.label.setPixmap(QtGui.QPixmap('mute.png')) elif value > 0 and value <= 30: self.label.setPixmap(QtGui.QPixmap('min.png')) elif value > 30 and value < 80: self.label.setPixmap(QtGui.QPixmap('med.png')) else: self.label.setPixmap(QtGui.QPixmap('max.png')) def main(): app = QtGui.QApplication(sys.argv) ex = Example() sys.exit(app.exec_()) if __name__ == '__main__': main() ``` 在我們的示例中，我們模擬了音量控制。 通過拖動滑塊的手柄，我們可以更改標簽上的圖像。 ```py sld = QtGui.QSlider(QtCore.Qt.Horizontal, self) ``` 在這里，我們創建一個水平`QtGui.QSlider`。 ```py self.label = QtGui.QLabel(self) self.label.setPixmap(QtGui.QPixmap('mute.png')) ``` 我們創建一個`QtGui.QLabel`小部件。 并為其設置初始靜音圖像。 ```py sld.valueChanged[int].connect(self.changeValue) ``` 我們將`valueChanged[int]`信號連接到用戶定義的`changeValue()`方法。 ```py if value == 0: self.label.setPixmap(QtGui.QPixmap('mute.png')) ... ``` 基于滑塊的值，我們將圖像設置為標簽。 在上面的代碼中，如果滑塊值等于零，則將`mute.png`圖像設置為標簽。  圖：`QtGui.QSlider`小部件 ## `QtGui.QProgressBar` 進度條是當我們處理冗長的任務時使用的小部件。 它具有動畫效果，以便用戶知道我們的任務正在進行中。 `QtGui.QProgressBar`小部件在 PySide 工具箱中提供了水平或垂直進度條。 程序員可以為進度條設置最小值和最大值。 默認值為 0，99。 ```py #!/usr/bin/python # -*- coding: utf-8 -*- """ ZetCode PySide tutorial This example shows a QtGui.QProgressBar widget. author: Jan Bodnar website: zetcode.com last edited: August 2011 """ import sys from PySide 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('QtGui.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') def main(): app = QtGui.QApplication(sys.argv) ex = Example() sys.exit(app.exec_()) if __name__ == '__main__': main() ``` 在我們的示例中，我們有一個水平進度條和一個按鈕。 該按鈕將啟動和停止進度條。 ```py self.pbar = QtGui.QProgressBar(self) ``` 這是一個`QtGui.QProgressBar`構造器。 ```py self.timer = QtCore.QBasicTimer() ``` 要激活進度條，我們使用計時器對象。 ```py self.timer.start(100, self) ``` 要啟動計時器事件，我們調用`start()`方法。 此方法有兩個參數。 超時和將接收事件的對象。 ```py 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) ``` 每個`QtCore.QObject`及其子代都有一個`timerEvent()`事件處理器。 為了對計時器事件做出反應，我們重新實現了事件處理器。 我們更新`self.step`變量，并為進度欄小部件設置一個新值。 ```py 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()`方法中，我們啟動和停止計時器。  圖：`QtGui.QProgressBar` ## `QtGui.QCalendarWidget` `QtGui.QCalendarWidget`提供基于月度的日歷小部件。 它允許用戶以簡單直觀的方式選擇日期。 ```py #!/usr/bin/python # -*- coding: utf-8 -*- """ ZetCode PySide tutorial This example shows a QtGui.QCalendarWidget widget. author: Jan Bodnar website: zetcode.com last edited: August 2011 """ import sys from PySide 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) cal.clicked[QtCore.QDate].connect(self.showDate) self.lbl = QtGui.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()) def main(): app = QtGui.QApplication(sys.argv) ex = Example() sys.exit(app.exec_()) if __name__ == '__main__': main() ``` 該示例具有日歷小部件和標簽小部件。 當前選擇的日期顯示在標簽窗口小部件中。 ```py self.cal = QtGui.QCalendarWidget(self) ``` 我們構造一個日歷小部件。 ```py cal.clicked[QtCore.QDate].connect(self.showDate) ``` 如果我們從小部件中選擇一個日期，則會發出`clicked[QtCore.QDate]`信號。 我們將此信號連接到用戶定義的`showDate()`方法。 ```py def showDate(self, date): self.lbl.setText(date.toString()) ``` 我們調用`selectedDate()`方法檢索所選日期。 然后，我們將日期對象轉換為字符串并將其設置為標簽小部件。  圖：`QtGui.QCalendarWidget`小部件 在 PySide 教程的這一部分中，我們介紹了幾個小部件。