徐高翔的个人网站

PyQt5系列教程(六)常用控件

2017-06-12

软硬件环境

  • Windows 10
  • Miniconda3 with python 3.7.1
  • PyQt5
  • PyCharm

前言

控件是PyQt5应用程序的基石。PyQt5自带很多不同的控件,包括像buttoncheck boxslider等等。在本节中我们将学习几个非常有用的控件,QCheckBoxToggleButtonQSliderQProgressBarQCalendarWidget

QCheckBox

一个QCheckBox会有2种状态:选中和未选中。它有一个选择框和一个label组成,它常常被用来表示应用的某些特性是可启用或不启用。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
# -*- coding: utf-8 -*-
__author__ = 'xugx.ai@gmail.com'


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_())

程序执行效果如下

qcheckbox_01

在这个例子中,我们创建了一个选择框,它状态的变化会引起窗口标题的变化。

1
cb = QCheckBox('Show title', self)

这条语句是QCheckBox的构造函数,它的labelShow title

1
cb.toggle()

设置默认是选中状态

1
cb.stateChanged.connect(self.changeTitle)

将自定义的槽函数changeTitle和信号stateChanged绑定起来,槽函数changeTitle会改变窗口的标题

1
2
3
4
5
6
def changeTitle(self, state):

if state == Qt.Checked:
self.setWindowTitle('QCheckBox')
else:
self.setWindowTitle('')

选中状态下,窗口标题设置为QCheckBox,否则设置为空

Toggle button

Toggle button是一种特殊的QPushButton(按钮),它也有2种状态,按下和未按下,我们通过点击它来区分2种不同的状态。实际很多情况下都会用到它。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
# -*- coding: utf-8 -*-
__author__ = 'xugx.ai@gmail.com'


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_())

代码执行效果如下所示

toggleButton_01

本例中我们创建了3个toggle button和一个QWidget,将QWidget的背景色设置成了黑色,左边的3个toggle button会改变右边QWidget的颜色。

1
2
redb = QPushButton('Red', self)
redb.setCheckable(True)

为了创建toggle button,我们首先创建一个QPushButton,然后调用方法setCheckable()。后面的信号和槽的绑定,相信大家都很熟悉了,这里就不说了。

QSlider

QSlider是一个滑动条,允许你在某一范围内拖动。有时候这种方式比输入数字或者使用spin box更加自然。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
# -*- coding: utf-8 -*-
__author__ = 'xugx.ai@gmail.com'


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_())

代码运行效果如下所示,我这没有加入图片,所以看不到右侧图片的变化。我这里只解释下QSlider的使用,信号和曹函数跟之前都是一样的。

qslider_01

1
2
3
4
sld = QSlider(Qt.Horizontal, self)
sld.setFocusPolicy(Qt.NoFocus)
sld.setGeometry(30, 40, 100, 30)
sld.valueChanged[int].connect(self.changeValue)

QSlider构造函数中传入Qt.Horizontal,创建的是一个横向的slider

QProgressBar

ProgressBar一般用来表示任务的进度,也有横向和众向之分。你可以设置进度条的最小值和最大值,默认是0和99。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
# -*- coding: utf-8 -*-
__author__ = 'xugx.ai@gmail.com'


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_())

代码运行效果如下所示

qprogressbar_01

这里使用一个计时器来启动进度条

1
2
3
4
5
6
7
8
9
10
11
12
self.timer = QtCore.QBasicTimer()

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()事件处理器,需要我们重新实现,它的第一个参数是超时时间

QCalendarWidget

QCalendarWidget是一个以月份为基础的日历控件,用来供用户选择日期

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
# -*- coding: utf-8 -*-
__author__ = 'xugx.ai@gmail.com'


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_())

代码运行效果如下所示

qcalendarwidget_01

QInputDialog

输入框是界面开发中非常常见的控件,比如下面场景,由用户输入生产订单号,当订单号不空且点击OK按钮时,则跳转到其他界面,否则,弹框报错,退出系统。

1
2
3
4
5
6
7
8
9
10
11
12

def showPONInputDialog(self):
opN,okPressed = QInputDialog.getText(self,"**科技","请输入生产订单号:",QLineEdit.Normal, " ")
if okPressed and opN.strip():
print('PON:' + opN)
logging.info('PON:' + opN)
self.poNumber = opN
self.lineedit_order.setText(self.poNumber)

else:
QMessageBox.critical(self,ERRORTITLE,"请输入订单号,点击OK进入系统!")
exit(1)

getText方法的返回值是一个元组(str,bool),样式为QLineEdit.Normal,常用的还有QLineEdit.Password。方法showPONInputDialog一般放在mainwindown中实现。

QInputDialog_01.png

备注

为了便于保存记录,在Github创建了一个工程,地址是: https://github.com/xugaoxiang/learningPyQt5,后续会把所有的代码、文档以及博文链接都放在上面。

参考文献

本文链接 https://xugaoxiang.com/2017/06/12/PyQt5系列教程(六)常用控件/

推荐文章(由hexo文章推荐插件驱动)

使用支付宝打赏
使用微信打赏

请博主喝咖啡!