控件
控件就像是应用这座房子的一块块砖。PyQt5有很多的控件,比如按 钮,单选框,滑动条,复选框等等
控件: QCheckBox , ToggleButton , QSlider , QProgressBar 和 QCale ndarWidget
一、QCheckBox
QCheckBox 组件有俩状态:开和关。通常跟标签一起使用,用在激活和 关闭一些选项的场景
例子中,有一个能切换窗口标题的单选框
代码实现:
from PyQt5.QtWidgets import QWidget, QCheckBox, QApplication
from PyQt5.QtCore import Qt
import sys
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
# 这个是 QCheckBox 的构造器
cb = 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('QCheckBox')
self.show()
# 控件的状态是由 changeTitle() 方法控制的,
# 如果空间被选中,我们就 给窗口添加一个标题,
# 如果没被选中,就清空标题
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_())
程序预览:
二、切换按钮
切换按钮就是 QPushButton 的一种特殊模式。 它只有两种状态:按下和未按下。我们再点击的时候切换两种状态,有很多场景会使用到这个功能
例子中创建了一个切换按钮和一个 QWidget ,并把 QWidget 的背景设置 为黑色。点击不同的切换按钮,背景色会在红、绿、蓝之间切换(而且 能看到颜色合成的效果,而不是单纯的颜色覆盖)
代码实现:
from PyQt5.QtWidgets import (QWidget, QPushButton,
QFrame, QApplication)
from PyQt5.QtGui import QColor
import sys
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
# 设置黑色颜色
self.col = QColor(0, 0, 0)
# 创建一个 QPushButton按钮
redb = QPushButton('Red', self)
# 调用setCheckable()把按钮变成切换按钮
redb.setCheckable(True)
redb.move(10, 10)
# 把点击信号和我们定义好的函数关联起来,把点击事件转换成布尔值
redb.clicked[bool].connect(self.setColor)
greenb = QPushButton('Green', self)
greenb.setCheckable(True)
greenb.move(10, 60)
greenb.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
# 如果是标签为“red”的按钮被点击,
# 就把颜色更改为预设好的对应颜色
if source.text() == "Red":
self.col.setRed(val)
elif source.text() == "Green":
self.col.setGreen(val)
else:
self.col.setBlue(val)
# 使用样式表(就是CSS的SS)改变背景色
self.square.setStyleSheet("QFrame { background-color: %s }" % self.col.name())
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
程序预览:
三、滑块
QSlider 是个有一个小滑块的组件,这个小滑块能拖着前后滑动,这个 经常用于修改一些具有范围的数值,比文本框或者点击增加减少的文本 框(spin box)方便多了
例子中用一个滑块和一个标签展示。标签为一个图片,滑块控制标签(的 值)
代码实现:
from PyQt5.QtWidgets import (QWidget, QSlider, QLabel, QApplication)
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QPixmap
import sys
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
# 创建一个水平的 QSlider
sld = QSlider(Qt.Horizontal, self)
sld.setFocusPolicy(Qt.NoFocus)
sld.setGeometry(30, 40, 100, 30)
# 把 valueChanged 信号跟 changeValue() 方法关联起来
sld.valueChanged[int].connect(self.changeValue)
# 创建一个 QLabel 组件并给它设置一个静音图标
self.label = QLabel(self)
self.label.setPixmap(QPixmap('default.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('default.png'))
elif value > 0 and value <= 30:
self.label.setPixmap(QPixmap('default.png'))
elif value > 30 and value < 80:
self.label.setPixmap(QPixmap('default.png'))
else:
self.label.setPixmap(QPixmap('default.png'))
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
程序预览:
四、进度条
进度条是用来展示任务进度的(我也不想这样说话)。它的滚动能让用 户了解到任务的进度。 QProgressBar 组件提供了水平和垂直两种进度条,进度条可以设置最大值和最小值,默认情况是0~99
例子中创建了一个水平的进度条和一个按钮,这个按钮控制进度条的开始和停止
代码实现:
from PyQt5.QtWidgets import (QWidget, QProgressBar,
QPushButton, QApplication)
from PyQt5.QtCore import QBasicTimer
import sys
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
# 新建一个 QProgressBar 构造器
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()
# 每个 QObject 和又它继承而来的对象都有一个 timerEvent()
# 事件处理函数。为了触发事件,我们重载了这个方法
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')
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
程序预览:
五、日历
QCalendarWidget 提供了基于月份的日历插件,十分简易而且直观
例子有日期组件和标签组件组成,标签显示被选中的日期
代码实现:
from PyQt5.QtWidgets import (QWidget, QCalendarWidget,
QLabel, QApplication, QVBoxLayout)
from PyQt5.QtCore import QDate
import sys
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
vbox = QVBoxLayout(self)
# 创建一个 QCalendarWidget
cal = QCalendarWidget(self)
cal.setGridVisible(True)
# 选择一个日期时, QDate 的点击信号就触发了,
# 把这个信号和我们自 己定义的 showDate() 方法关联起来
cal.clicked[QDate].connect(self.showDate)
vbox.addWidget(cal)
self.lbl = QLabel(self)
# 获取选中的日期
date = cal.selectedDate()
self.lbl.setText(date.toString())
vbox.addWidget(self.lbl)
self.setLayout(vbox)
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_())
程序预览:
六、图片
QPixmap 是处理图片的组件。本例中,我们使用 QPixmap 在窗口里显示一张图片
代码实现:
from PyQt5.QtWidgets import (QWidget, QHBoxLayout,
QLabel, QApplication)
from PyQt5.QtGui import QPixmap
import sys
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
hbox = QHBoxLayout(self)
# 创建一个 QPixmap 对象,接收一个文件作为参数
pixmap = QPixmap("default.png")
# 把 QPixmap 实例放到 QLabel 组件里
lbl = QLabel(self)
lbl.setPixmap(pixmap)
hbox.addWidget(lbl)
self.setLayout(hbox)
self.move(300, 200)
self.setWindowTitle('Red Rock')
self.show()
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
程序预览:
七、行编辑
QLineEdit 组件提供了编辑文本的功能,自带了撤销、重做、剪切、粘贴、拖拽等功能
例子中展示了一个编辑组件和一个标签,我们在输入框里键入的文本, 会立即在标签里显示出来
代码实现:
import sys
from PyQt5.QtWidgets import (QWidget, QLabel,
QLineEdit, QApplication)
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
self.lbl = QLabel(self)
# 创建一个 QLineEdit 对象
qle = QLineEdit(self)
qle.move(60, 100)
self.lbl.move(60, 40)
# 如果输入框的值有变化,就调用 onChanged() 方法
qle.textChanged[str].connect(self.onChanged)
self.setGeometry(300, 300, 280, 170)
self.setWindowTitle('QLineEdit')
self.show()
# 在 onChanged() 方法内部,我们把文本框里的值赋值给了标签组件,
# 然后调用 adjustSize() 方法让标签自适应文本内容
def onChanged(self, text):
self.lbl.setText(text)
self.lbl.adjustSize()
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
程序预览:
八、QSplitter
QSplitter 组件能让用户通过拖拽分割线的方式改变子窗口大小的组 件。本例中我们展示用两个分割线隔开的三个 QFrame 组件
三个窗口和两个分割线的布局创建完成了,但是要注意,有些主题下, 分割线的显示效果不太好
代码实现:
import sys
from PyQt5.QtWidgets import (QWidget, QHBoxLayout, QFrame,
QSplitter, QStyleFactory, QApplication)
from PyQt5.QtCore import Qt
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
hbox = QHBoxLayout(self)
# 为了更清楚的看到分割线,
# 我们使用了设置好的子窗口样式
topleft = QFrame(self)
topleft.setFrameShape(QFrame.StyledPanel)
topright = QFrame(self)
topright.setFrameShape(QFrame.StyledPanel)
bottom = QFrame(self)
bottom.setFrameShape(QFrame.StyledPanel)
# 创建一个 QSplitter 组件,并在里面添加了两个框架
splitter1 = QSplitter(Qt.Horizontal)
splitter1.addWidget(topleft)
splitter1.addWidget(topright)
splitter2 = QSplitter(Qt.Vertical)
# 也可以在分割线里面再进行分割
splitter2.addWidget(splitter1)
splitter2.addWidget(bottom)
hbox.addWidget(splitter2)
self.setLayout(hbox)
self.setGeometry(300, 300, 300, 200)
self.setWindowTitle('QSplitter')
self.show()
def onChanged(self, text):
self.lbl.setText(text)
self.lbl.adjustSize()
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
程序预览:
九、下拉选框
QComboBox 组件能让用户在多个选择项中选择一个
例子中包含了一个 QComboBox 和一个 QLabel 。下拉选择框有五个选项, 都是Linux的发行版名称,标签内容为选定的发行版名称
代码实现:
from PyQt5.QtWidgets import (QWidget, QLabel,
QComboBox, QApplication)
import sys
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
self.lbl = QLabel("Ubuntu", self)
# 创建一个 QComboBox 组件和五个选项
combo = QComboBox(self)
combo.addItem("Ubuntu")
combo.addItem("Mandriva")
combo.addItem("Fedora")
combo.addItem("Arch")
combo.addItem("Gentoo")
combo.move(50, 50)
self.lbl.move(50, 150)
# 在选中的条目上调用 onActivated() 方法
combo.activated[str].connect(self.onActivated)
self.setGeometry(300, 300, 300, 200)
self.setWindowTitle('QComboBox')
self.show()
# 在方法内部,设置标签内容为选定的字符串,
# 然后设置自适应文本大小
def onActivated(self, text):
self.lbl.setText(text)
self.lbl.adjustSize()
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
程序预览: