小部件是应用程序的基本构建块。PyQt4有各种各样的小部件,包括按钮、复选框、滑块或列表框。在本教程的这一部分中,我们将介绍几个有用的小部件:QtGui.QCheckBox、ToggleButton、QtGui.QSlider、QtGui.QProgressBar和QtGui.QCalendarWidget。
QtGui.QCheckBox
QtGui.QCheckBox是一个具有两种状态的小部件:断断续续这是一个有标签的盒子。复选框通常用于表示应用程序中可以启用或禁用的功能。
#!/usr/bin/python
"""
ZetCode PyQt4 tutorial
In this example, a QtGui.QCheckBox widget
is used to toggle the title of a window.
author: Jan Bodnar
website: zetcode.com
"""
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()
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('QtGui.QCheckBox')
else:
self.setWindowTitle('')
def main():
app = QtGui.QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
在我们的示例中,我们将创建一个复选框来切换窗口标题。
cb = QtGui.QCheckBox('Show title', self)
这是一个QtGui.QCheckBox构造函数。
cb.toggle()
我们已经设置了窗口标题,所以我们还必须选中复选框。默认情况下,窗口标题未设置,复选框未选中。
cb.stateChanged.connect(self.changeTitle)
我们将用户定义的changeTitle方法连接到stateChanged信号。changeTitle方法将切换窗口标题。
def changeTitle(self, state):
if state == QtCore.Qt.Checked:
self.setWindowTitle('QtGui.QCheckBox')
else:
self.setWindowTitle('')
小部件的状态被提供给state变量中的changeTitle方法。如果选中了小部件,我们设置窗口的标题。否则,我们将为标题栏设置一个空字符串。
ToggleButton
切换按钮是特殊模式下的QtGui.QPushButton。它是一个具有两种状态的按钮:按下和不按下。我们通过点击它在这两种状态之间切换。在某些情况下,此功能非常适合。
#!/usr/bin/python
"""
ZetCode PyQt4 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
"""
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)
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()
在我们的示例中,我们创建了三个切换按钮和一个QtGui.QWidget。我们将QtGui.QWidget的背景颜色设置为黑色。切换按钮将切换颜色值的红色、绿色和蓝色部分。背景颜色将取决于我们按下的切换按钮。
self.col = QtGui.QColor(0, 0, 0)
这是初始的黑色颜色值。
redb = QtGui.QPushButton('Red', self)
redb.setCheckable(True)
redb.move(10, 10)
要创建切换按钮,我们创建一个QtGui.QPushButton,并通过调用setCheckable方法使其可检查。
redb.clicked[bool].connect(self.setColor)
我们将一个clicked信号连接到用户定义的方法。我们使用点击的信号,它与布尔值一起操作。
source = self.sender()
我们得到了被切换的按钮。
if source.text() == "Red":
self.col.setRed(val)
如果它是一个红色按钮,我们会相应地更新颜色的红色部分。
self.square.setStyleSheet("QFrame { background-color: %s }" %
self.col.name())
我们使用样式表来改变背景颜色。
QtGui.QSlider
QSlider是一个具有简单句柄的小部件。这个把手可以前后拉。这样,我们就为特定任务选择了一个值。有时使用滑块比输入数字或使用数字显示框更自然。
在我们的示例中,我们将显示一个滑块和一个标签。此时标签将显示一个图像。滑块将控制标签。
#!/usr/bin/python
"""
ZetCode PyQt4 tutorial
This example shows a QtGui.QSlider widget.
author: Jan Bodnar
website: zetcode.com
"""
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)
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()
在我们的例子中,我们模拟了一个音量控制。通过拖动滑块的手柄,我们可以更改标签上的图像。
sld = QtGui.QSlider(QtCore.Qt.Horizontal, self)
这里我们创建一个水平的QtGui.QSlider。
self.label = QtGui.QLabel(self)
self.label.setPixmap(QtGui.QPixmap('mute.png'))
我们创建一个QtGui.QLabel小部件,并为其设置一个初始静音图像。
sld.valueChanged[int].connect(self.changeValue)
我们将valueChanged信号连接到用户定义的changeValue()方法。
if value == 0:
self.label.setPixmap(QtGui.QPixmap('mute.png'))
...
根据滑块的值,我们将图像设置为标签。在上面的代码中,如果滑块等于零,我们将mute.png图像设置为标签。
QtGui.QProgressBar
进度条是一个小部件,用于处理冗长的任务。它是动画的,以便用户知道任务正在进行。QProgressBar小部件在PyQt4工具包中提供了一个水平或垂直进度条。程序员可以设置进度条的最小值和最大值。默认值为0和99。
#!/usr/bin/python
"""
ZetCode PyQt4 tutorial
This example shows a QtGui.QProgressBar widget.
author: Jan Bodnar
website: zetcode.com
"""
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('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()
在我们的示例中,我们有一个水平进度条和一个按钮。按钮启动和停止进度条。
self.pbar = QtGui.QProgressBar(self)
这是一个QtGui.QProgressBar构造函数。
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)
每个QtCore.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方法中,我们启动和停止计时器。
QtGui.QCalendarWidget
QCalendarWidget提供了一个基于每月的日历小部件。它允许用户以简单和直观的方式选择日期。
#!/usr/bin/python
"""
ZetCode PyQt4 tutorial
This example shows a QtGui.QCalendarWidget widget.
author: Jan Bodnar
website: zetcode.com
"""
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)
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()
该示例有一个日历小部件和一个标签小部件。当前选定的日期显示在标签小部件中。
cal = QtGui.QCalendarWidget(self)
我们构造一个日历小部件。
cal.clicked[QtCore.QDate].connect(self.showDate)
如果我们从小部件中选择一个日期,就会发出一个点击的[QtCore.QDate]信号。我们将这个信号连接到用户定义的showDate方法。
def showDate(self, date):
self.lbl.setText(date.toString())
我们通过调用selectedDate方法来检索所选日期。然后,我们将date对象转换为字符串,并将其设置为label小部件。
在PyQt4教程的这一部分中,我们介绍了几个小部件。