PyQt5:常用控件

0、概述  

控件是开发GUI程序必不可少的组成部分。就像盖房子用到的砖和瓦一样。PyQt5中的控件很多,本文介绍接种常用控件,其他控件的应用大同小异。

  QAbstractButton类为抽象类,不能实例化,必须由其他的按钮类继承QAbstractButton类,来实现不同的功能和表现形式,常见的按钮QPushButton,QToolButton,QRadioButton和QCheckBox这些按钮均继承自QAbstractButton类,根据各自的使用场景通过图形显示出来。

QAbstractButton提供的状态如下表

状态 含义
isDown() 提示按钮是否已按下
isChecked()  提示按钮是否已经标记
isEnable()  提示按钮是否可以被用户点击
isCheckAble()  提示按钮是否为可标记的
setAutoRepeat()  设置按钮是否在用户长按时可以自动重复执行

QAbstractButton提供的信号如下表

信号 含义
Pressed 当鼠标指针在按钮上并按下左键时触发该信号
Released 当鼠标左键被释放时触发该信号
Clicked  当鼠标左键被按下然后释放时,或者快捷键被释放时触发该信号
Toggled Toggled

1、QPushButton控件(按钮控件)

   QPushButton控件是一个按钮控件,不过这个按钮控件支持两种状态,一种是Normal状态,另一种是Checked状态。Normal状态就是正常的未按下的状态,而Checked状态就是按钮被按下的状态,按下后颜色变为蓝色,表示已经被选中。

1.1 QPUshButton类中的常用方法

方法 描述
 setCheckable()   设置按钮是否已经被选中,如果设置True,则表示按钮将保持已点击和释放状态
 toggle()   在按钮状态之间进行切换
 setIcon()   设置按钮上的图标
 setEnabled()   设置按钮是否可以使用,当设置为False时,按钮变成不可用状态,点击它不会发射信号
 isChecked()   返回按钮的状态,返回值为True或者False
 setDefault()   设置按钮的默认状态
 setText()   设置按钮的显示文本
 text()   返回按钮的显示文本

1.2 为QPushButton设置快捷键

  通过按钮名字能为QPushButton设置快捷键,比如名字为‘&Download’的按键,它的快捷键是‘Alt+D’。其规则是;想要实现快捷键为“Alt+D”,那么按钮的名字里有D这个字母,并且在D的前面加上“&”,这个字母D一般是按钮名称的首字母,而且在按钮显示时。“&”不会显示出来,如果想显示,那么需要转义,核心代码如下

1.3 实例1

   本例中,在窗口上放置三个QPushButton控件和一个QFrame控件,这三个QPushButton控件分别表示红蓝绿三种状态。当单击某一个或某几个按钮时,就会分别设置RGB的每个颜色分量,并将设置后的颜色设为QFrame控件的背景色。

import sys
import PyQt5.QtWidgets as PQW
import PyQt5.QtGui as PQG

#########################################
# 1、QPushButton按钮控件
class PushButton(PQW.QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        # 创建QColor对象,初始化颜色为黑色。RGB格式
        self.color = PQG.QColor(0, 0, 0)

        # 创建表示红色的QPushButton按钮
        redButton = PQW.QPushButton('红色',self)
        # 必须用setCheckable(True)才能让按钮可以设置两种状态。
        redButton.setCheckable(True)
        redButton.move(10,10)
        # 将setColor方法与按钮的单击事件关联,bool是一个类,表示setColor参数类型是一个布尔类型
        # 这个布尔类型的参数值表示按钮按下和抬起两种状态。
        redButton.clicked[bool].connect(self.setColor)

        # 创建表示绿色的QPushButton按钮
        greenButton = PQW.QPushButton('绿色',self)
        greenButton.setCheckable(True)
        greenButton.move(10,60)
        greenButton.clicked[bool].connect(self.setColor)

        # 创建表示蓝色的QPushButton按钮
        blueButton = PQW.QPushButton('蓝色',self)
        blueButton.setCheckable(True)
        blueButton.move(10,110)
        blueButton.clicked[bool].connect(self.setColor)

        # 创建用于显示当前颜色的QFrame对象。
        self.square = PQW.QFrame(self)
        self.square.setGeometry(150,20,100,100)
        # 设置QFrame的背景色。
        self.square.setStyleSheet("QWidget { background-color: %s }" % self.color.name())

        self.setGeometry(300,200,280,170)
        self.setWindowTitle('按钮控件')
        self.show()

    # 按钮的单击事件方法,3个按钮共享着一个方法。
    def setColor(self,pressed):
        # 获取单击的哪一个按钮
        source = self.sender()
        # pressed就是前面clicked[bool]中指定的布尔类型参数值。
        if pressed:
            val = 255
        else:
            val = 0
        # 遍历是哪个按钮操作
        if source.text()=='红色':
            self.color.setRed(val)
        elif source.text()=='绿色':
            self.color.setGreen(val)
        else:
            self.color.setBlue(val)

        self.square.setStyleSheet("QFrame {background-color: %s}" %self.color.name())

if __name__ == '__main__':
    app = PQW.QApplication(sys.argv)
    ex = PushButton()
    sys.exit(app.exec_())

 1.4 实例2

 1 import sys
 2 from PyQt5.QtCore import *
 3 from PyQt5.QtGui import *
 4 from PyQt5.QtWidgets import *
 5 
 6 class Form(QDialog):
 7     def __init__(self,parent=None):
 8         super(Form, self).__init__(parent)
 9 
10         #垂直布局
11         layout=QVBoxLayout()
12 
13         #创建按钮1
14         self.btn1=QPushButton('Button1')
15         #setCheckable():设置按钮是否已经被选中,如果为True,则表示按钮将保持已点击和释放状态
16         self.btn1.setCheckable(True)
17         #toggle():在按钮状态之间进行切换
18         self.btn1.toggle()
19         #点击信号与槽函数进行连接,这一步实现:在控制台输出被点击的按钮
20         self.btn1.clicked.connect(lambda :self.whichbtn(self.btn1))
21         #点击信号与槽函数进行连接,实现的目的:输入安妞的当前状态,按下还是释放
22         self.btn1.clicked.connect(self.btnstate)
23 
24         #添加控件到布局中
25         layout.addWidget(self.btn1)
26 
27         #创建按钮2
28         self.btn2=QPushButton('image')
29         #为按钮2添加图标
30         self.btn2.setIcon(QIcon(QPixmap('computerIcon.png')))
31         ##点击信号与槽函数进行连接,这一步实现:在控制台输出被点击的按钮
32         self.btn2.clicked.connect(lambda :self.whichbtn(self.btn2))
33 
34         layout.addWidget(self.btn2)
35 
36         self.btn3=QPushButton('Disabled')
37         #setEnabled()设置按钮是否可以使用,当设置为False的时候,按钮变成不可用状态,点击它不会发射信号
38         self.btn3.setEnabled(False)
39 
40         layout.addWidget(self.btn3)
41 
42         #创建按钮并添加快捷键
43         self.btn4=QPushButton('&Download')
44         #setDefault():设置按钮的默认状态
45         self.btn4.setDefault(True)
46         ##点击信号与槽函数进行连接,这一步实现:在控制台输出被点击的按钮
47         self.btn4.clicked.connect(lambda :self.whichbtn(self.btn4))
48 
49         layout.addWidget(self.btn4)
50 
51         self.setWindowTitle("Button demo")
52         self.setLayout(layout)
53 
54     def btnstate(self):
55         #isChecked():判断按钮的状态,返回值为True或False
56         if self.btn1.isChecked():
57             print('button pressed')
58         else:
59             print('button released')
60 
61     def whichbtn(self,btn):
62         #输出被点击的按钮
63         print('clicked button is '+btn.text())
64 if __name__ == '__main__':
65     app=QApplication(sys.argv)
66     btnDemo=Form()
67     btnDemo.show()
68     sys.exit(app.exec_())
View Code

 

代码分析:

  在这个例子中,创建了四个按钮,这四个QPushButton对象被定义为类的实例变量,每个按钮都将clicked的信号发送给指定的槽函数,来响应按钮点击的事件。第一个按钮btn1,**通过toggle()函数来切换按钮的状态,其核心代码是:

self.btn1=QPushButton('Button1') 
self.btn1.setCheckable(True) 
self.btn1.toggle()

   当这个按钮点击时,将clicked信号发送给槽函数btnstate(),通过btn.isChecked来获得按钮是否被点击或者释放的状态,其核心代码是:

self.btn1.clicked.connect(self.btnstate)

  还可以通过lambda表达式来传递额外的参数btn1,将clicked信号发送给槽函数whichbtn(),其核心代码:

self.btn1.clicked.connect(lambda :self.whichbtn(self.btn1))

  第二个按钮btn2,上面显示一个图标,使用setIcon()方法接受一个QPixmap对象的图像文件作为输入参数,其核心代码是:

self.btn2.setIcon(QIcon(QPixmap('computerIcon.png')))

  第三个按钮btn3,使用setEnabled()方法来禁用btn3按钮 

self.btn3.setEnabled(False)

  第四个按钮btn4,使用setDefault()方法·来设置按钮的默认状态。快捷键是‘&+文本’(&Download),通过‘Alt+D’快捷键来调用槽函数。

self.btn4=QPushButton('&Download'

2、QLineEdit控件:单行文本控件。

 1 class LineEdit(PQW.QWidget):
 2     def __init__(self):
 3         super().__init__()
 4         self.initUI()
 5 
 6     def initUI(self):
 7         self.label = PQW.QLabel('显示数据',self)
 8         lineEdit = PQW.QLineEdit(self)
 9         lineEdit.move(80,100)
10         self.label.move(80,40)
11         lineEdit.textChanged[str].connect(self.onChanged)
12         self.setGeometry(300,300,300,200)
13         self.setWindowTitle('当行文本控件QLineEdit')
14         self.show()
15 
16     def onChanged(self, str):
17         self.label.setText(str)
18         self.label.adjustSize()
19 
20 if __name__ == '__main__':
21     app = PQW.QApplication(sys.argv)
22     ex = LineEdit()
23     sys.exit(app.exec_())
View Code

  QLineEdit类中常用的方法如下表:

方法 描述
setAlignment()

按固定值方式对齐文本
Qt.AlignLeft:水平方向靠左对齐
Qt.AlignRight:水平方向靠右对齐
Qt.AlignCenter:水平方向居中对齐
Qt.AlignJustify:水平方向调整间距两端对齐
Qt.AlignTop:垂直方向靠上对齐
Qt.AlignBottom:垂直方向靠下对齐
Qt.AlignVCenter:垂直方向居中对齐

setEchoMode()

设置文本框的显示格式,允许输入的文本显示格式的值可以是:
QLineEdit.Normal:正常显示所输入的字符,此为默认选项
QLineEdit.NoEcho:不显示任何输入的字符,常用于密码类型的输入,且长度保密
QLineEdit.Password:显示与平台相关的密码掩饰字符,而不是实际输入的字符
QLineEdit.PasswordEchoOnEdit:在编辑时显示字符,负责显示密码类型的输入

setPlaceholderText() 设置文本框显示文字
setMaxLength() 设置文本框所允许输入的最大字符数
setReadOnly() 设置文本为只读
setText() 设置文本框的内容
text() 返回文本框的内容
setDragEnable() setDragEnable()
selectAll() 全选
setFocus() 获得焦点
setInputMask() 设置掩码
setValidator()

设置文本框的验证器(验证规则),将限制任意可能输入的文本,可用的校验器为
QIntValidator:限制输入整数
QDoubleValidator:限制输入浮点数
QRegexpValidator:检查输入是否符合正则表达式

  QLineEdit类中常用信号如下:

信号 描述
selectionChanged 只要选择改变了,这个信号就会发射
textChanged 当修改文本内容时,这个信号就会发射
editingFinished 当编辑文本结束时,这个信号就会发射

  定义输入掩码的字符 
  下表列出了输入掩码的占位符和字面字符,并说明其如何控制数据输入:

 PyQt5:常用控件_第1张图片

  掩码由掩码字符与分隔符字符串组成,后面可以跟一个分号和空白字符,空白字符在编辑后会从文本删除的 
  掩码示例如下:

掩码 注意事项
000.000.000.000;_ ip地址,空白字符是‘_’
HH:HH:HH:HH:HH:HH; MAC地址
0000-00-00 日期,空白字符是空格
>AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;# 许可证号,空白字符是‘_’,所有字母都转换为大写

 实例一、EchoMode的显示效果

 1 from PyQt5.QtWidgets import QApplication,QLineEdit,QWidget,QFormLayout
 2 import sys
 3 
 4 class lineEditDemo(QWidget):
 5     def __init__(self,parent=None):
 6         super(lineEditDemo, self).__init__(parent)
 7         self.setWindowTitle('QLineEdit例子')
 8 
 9         #实例化表单布局
10         flo=QFormLayout()
11 
12         #创建4个文本输入框
13         PNormalLineEdit=QLineEdit()
14         pNoEchoLineEdit=QLineEdit()
15         pPasswordListEdit=QLineEdit()
16         pPasswordEchoOnEditLineEdit=QLineEdit()
17 
18         #添加到表单布局中
19         #flo.addRow(文本名称(可以自定义),文本框)
20         flo.addRow('Normal',PNormalLineEdit)
21         flo.addRow('NoEcho', pNoEchoLineEdit)
22         flo.addRow('Password', pPasswordListEdit)
23         flo.addRow('PasswordEchoOnEdit', pPasswordEchoOnEditLineEdit)
24 
25         #设置setPlaceholderText()文本框浮现的文字
26         PNormalLineEdit.setPlaceholderText('Normal')
27         pNoEchoLineEdit.setPlaceholderText('NoEcho')
28         pPasswordListEdit.setPlaceholderText('Password')
29         pPasswordEchoOnEditLineEdit.setPlaceholderText('PasswordEchoOnEdit')
30 
31         #setEchoMode():设置显示效果
32 
33         #QLineEdit.Normal:正常显示所输入的字符,此为默认选项
34         PNormalLineEdit.setEchoMode(QLineEdit.Normal)
35         #QLineEdit.NoEcho:不显示任何输入的字符,常用于密码类型的输入,且长度保密
36         pNoEchoLineEdit.setEchoMode(QLineEdit.NoEcho)
37         #QLineEdit.Password:显示与平台相关的密码掩饰字符,而不是实际输入的字符
38         pPasswordListEdit.setEchoMode(QLineEdit.Password)
39         #QLineEdit.PasswordEchoOnEdit:在编辑时显示字符,负责显示密码类型的输入
40         pPasswordEchoOnEditLineEdit.setEchoMode(QLineEdit.PasswordEchoOnEdit)
41 
42         #设置窗口的布局
43         self.setLayout(flo)
44 
45 if __name__ == '__main__':
46     app=QApplication(sys.argv)
47     win=lineEditDemo()
48     win.show()
49     sys.exit(app.exec_())
View Code

 显示效果:

PyQt5:常用控件_第2张图片  PyQt5:常用控件_第3张图片

刚启动窗口                                                       填完参数后的窗口

 实例二、验证器

 1 #导入,Qapplication,单行文本框,窗口,表单布局
 2 from PyQt5.QtWidgets import QApplication,QLineEdit,QWidget,QFormLayout
 3 #导入文本校验器:整数校验器与浮点数校验器,其他自定义校验器
 4 from PyQt5.QtGui import QIntValidator,QDoubleValidator,QRegExpValidator
 5 
 6 from PyQt5.QtCore import QRegExp
 7 import sys
 8 
 9 class lineEditDemo(QWidget):
10     def __init__(self,parent=None):
11         super(lineEditDemo, self).__init__(parent)
12         self.setWindowTitle('QLineEdit例子')
13 
14         #实例化表单布局
15         flo=QFormLayout()
16 
17         #创建三个文本框
18         pIntLineEdit=QLineEdit()
19         pDoubleLineEdit=QLineEdit()
20         pValidatorLineEdit=QLineEdit()
21 
22         #表单布局添加名称及控件
23         flo.addRow('整型',pIntLineEdit)
24         flo.addRow('浮点型',pDoubleLineEdit)
25         flo.addRow('字母和数字',pValidatorLineEdit)
26 
27         #设置文本框的默认浮现文本
28         pIntLineEdit.setPlaceholderText('整型,1-99')
29         pDoubleLineEdit.setPlaceholderText('浮点型,-360到360,精度2位小数')
30         pValidatorLineEdit.setPlaceholderText('字母和数字')
31 
32         #整型 范围 【1-99】
33         #实例化整型验证器,并设置范围为1-99
34         pIntvalidator=QIntValidator(self)
35         pIntvalidator.setRange(1,99)
36 
37         #浮点型 范围 【-360,360】,精度小数点后两位
38         #实例化浮点验证器,设置范围-360到360
39         pDoubleValidator=QDoubleValidator()
40         pDoubleValidator.setRange(-360,360)
41 
42         pDoubleValidator.setNotation(QDoubleValidator.StandardNotation)
43         #设置精度小数点后两位
44         pDoubleValidator.setDecimals(2)
45 
46         #字母和数字
47         #设置文本允许出现的字符内容
48         reg=QRegExp('[a-zA-Z0-9]+$')
49         #自定义文本验证器
50         pValidator=QRegExpValidator(self)
51         #设置属性
52         pValidator.setRegExp(reg)
53 
54         #设置验证器
55         pIntLineEdit.setValidator(pIntvalidator)
56         pDoubleLineEdit.setValidator(pDoubleValidator)
57         pValidatorLineEdit.setValidator(pValidator)
58 
59         self.setLayout(flo)
60 if __name__ == '__main__':
61     app=QApplication(sys.argv)
62     win=lineEditDemo()
63     win.setGeometry(300,300,500,20)
64     win.show()
65     sys.exit(app.exec_())
View Code

  显示效果:

PyQt5:常用控件_第4张图片

实例三、输入掩码 

 1 from PyQt5.QtWidgets import QApplication,QLineEdit,QFormLayout,QWidget
 2 import sys
 3 
 4 class lineEditDemo(QWidget):
 5     def __init__(self,parent=None):
 6         super(lineEditDemo, self).__init__(parent)
 7         self.setWindowTitle('QlineEdit的掩码输入例子')
 8 
 9         #实例化表单布局
10         flo=QFormLayout()
11         #创建4个文本框
12         pIPlineEdit=QLineEdit()
13         pMAXlineEdit=QLineEdit()
14         pDatelineEdit=QLineEdit()
15         pLiceseLineEdit=QLineEdit()
16 
17         #setInputMask():设置掩码
18 
19         #ip地址掩码
20         pIPlineEdit.setInputMask('000.000.000.000;_')
21         #Mac地址掩码
22         pMAXlineEdit.setInputMask('HH:HH:HH:HH:HH:HH;_')
23         #日期掩码
24         pDatelineEdit.setInputMask('0000-00-00')
25         #许可证掩码
26         pLiceseLineEdit.setInputMask('>AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;#')
27 
28 
29         #添加名称与控件到表单布局中
30         flo.addRow('数字掩码',pIPlineEdit)
31         flo.addRow('Mac掩码',pMAXlineEdit)
32         flo.addRow('日期掩码',pDatelineEdit)
33         flo.addRow('许可证掩码',pLiceseLineEdit)
34 
35         #设置窗口的布局
36         self.setLayout(flo)
37 if __name__ == '__main__':
38     app=QApplication(sys.argv)
39     win=lineEditDemo()
40     win.show()
41     sys.exit(app.exec_())
View Code

 

显示效果:

PyQt5:常用控件_第5张图片     PyQt5:常用控件_第6张图片

 实例四:综合实例

 

 1 from PyQt5.QtWidgets import QApplication,QLineEdit,QFormLayout,QWidget
 2 from PyQt5.QtGui import QIntValidator,QDoubleValidator,QFont
 3 from PyQt5.QtCore import Qt
 4 import sys
 5 
 6 class lineEditDemo(QWidget):
 7     def __init__(self,parent=None):
 8         super(lineEditDemo, self).__init__(parent)
 9 
10         #创建文本
11         e1=QLineEdit()
12         #设置文本校验器为整数,只有输入整数才为有效值
13         e1.setValidator(QIntValidator())
14         #设置允许输入的最大字符数
15         e1.setMaxLength(4)
16         #设置文本靠右对齐
17         e1.setAlignment(Qt.AlignRight)
18         #设置文本的字体和字号大小
19         e1.setFont(QFont('Arial',20))
20 
21         #创建文本
22         e2=QLineEdit()
23         #设置浮点型校验器,有效范围(0.99-99.99),保留两位小数
24         e2.setValidator(QDoubleValidator(0.99,99.99,2))
25 
26         #表单布局
27         flo=QFormLayout()
28         #添加名称及控件到布局中
29         flo.addRow('integer validator',e1)
30         flo.addRow('Double  Validator',e2)
31 
32         #创建文本
33         e3=QLineEdit()
34         #定义文本输入掩码,9:ASCII字母字符是必须输入的(0-9)
35         e3.setInputMask('+99_9999_999999')
36 
37         flo.addRow('Input Mask',e3)
38 
39 
40         e4=QLineEdit()
41         #文本修改信号发射与槽函数的绑定
42         e4.textChanged.connect(self.textchanged)
43 
44         flo.addRow('Text changed',e4)
45 
46         e5=QLineEdit()
47         #设置文本框显示的格式,QLineEdit.Password:显示密码掩码字符,而不是实际输入的字符
48         e5.setEchoMode(QLineEdit.Password)
49         flo.addRow('Password',e5)
50 
51         #创建文本框并增添文本框的内容
52         e6=QLineEdit('HELLO PyQt5')
53         #设置属性为只读
54         e6.setReadOnly(True)
55         flo.addRow('Read Only',e6)
56         #编译完成的信号与槽函数的绑定
57         e5.editingFinished.connect(self.enterPress)
58 
59         #设置窗口的布局
60         self.setLayout(flo)
61 
62         self.setWindowTitle("QLinedit例子")
63 
64     def textchanged(self,text):
65         print('输入的内容为'+text)
66 
67     def enterPress(self):
68         print('已输入')
69 if __name__ == '__main__':
70     app=QApplication(sys.argv)
71     win=lineEditDemo()
72     win.show()
73     sys.exit(app.exec_())
View Code

 

显示效果:

PyQt5:常用控件_第7张图片

3、QCheckBox控件

  QCheckBox控件是复选框控件,用于进行二值选择。也可以多个QCheckBox控件在一起使用,用于对多个设置项进行多选操作。QCheckBox控件默认的是未选中状态,调用QCheckBox对象的toggle方法可以让QCheckBox控件处于选中状态。常用的事件:stateChecked,当QCheckBox控件选中状态发生变化时就会触发该事件。

(1)简单实例:

 1 class checkBox(PQW.QWidget):
 2     def __init__(self):
 3         super().__init__()
 4         self.initUI()
 5     def initUI(self):
 6         cb = PQW.QCheckBox('使能',self)
 7         cb.move(20,20)
 8         cb.toggle()
 9         cb.stateChanged.connect(self.changTitle)
10         self.setWindowTitle('还没开始')
11         self.show()
12     def changTitle(self,state):
13         if state == PQC.Qt.Checked:
14             self.setWindowTitle('选中')
15         else:
16             self.setWindowTitle('没选中')
17 if __name__ == '__main__':
18     app = PQW.QApplication(sys.argv)
19     ex = checkBox()
20     sys.exit(app.exec_())
View Code

  QCheckBox类中常用方法:

QCheckBox类中常用方法
setChecked() 设置复选框的状态,设置为True表示选中,False表示取消选中的复选框
setText() 设置复选框的显示文本
text() 返回复选框的显示文本
isChecked() 检查复选框是否被选中
setTriState() 设置复选框为一个三态复选框
setCheckState() 三态复选框的状态设置,具体设置可以见下表

  三态复选框的三种状态:

名称 含义
Qt.Checked 0 组件被选中
Qt.PartiallyChecked 1 组件被半选中
Qt.Unchecked 2 组件没有被选中(默认)

(2)复杂一点的实例

 1 import sys
 2 from PyQt5.QtCore import *
 3 from PyQt5.QtGui import *
 4 from PyQt5.QtWidgets import *
 5 from PyQt5.QtCore import Qt
 6 
 7 
 8 class CheckBoxDemo(QWidget):
 9 
10     def __init__(self, parent=None):
11         super(CheckBoxDemo, self).__init__(parent)
12 
13         #创建一个GroupBox组
14         groupBox = QGroupBox("Checkboxes")
15         groupBox.setFlat(False)
16 
17         #创建复选框1,并默认选中,当状态改变时信号触发事件
18         self.checkBox1 = QCheckBox("&Checkbox1")
19         self.checkBox1.setChecked(True)
20         self.checkBox1.stateChanged.connect(lambda: self.btnstate(self.checkBox1))
21 
22         #创建复选框,标记状态改变时信号触发事件
23         self.checkBox2 = QCheckBox("Checkbox2")
24         self.checkBox2.toggled.connect(lambda: self.btnstate(self.checkBox2))
25 
26         #创建复选框3,设置为3状态,设置默认选中状态为半选状态,当状态改变时信号触发事件
27         self.checkBox3 = QCheckBox("tristateBox")
28         self.checkBox3.setTristate(True)
29         self.checkBox3.setCheckState(Qt.PartiallyChecked)
30         self.checkBox3.stateChanged.connect(lambda: self.btnstate(self.checkBox3))
31 
32         #水平布局
33         layout = QHBoxLayout()
34         #控件添加到水平布局中
35         layout.addWidget(self.checkBox1)
36         layout.addWidget(self.checkBox2)
37         layout.addWidget(self.checkBox3)
38 
39         #设置QGroupBox组的布局方式
40         groupBox.setLayout(layout)
41 
42         #设置主界面布局垂直布局
43         mainLayout = QVBoxLayout()
44         #QgroupBox的控件添加到主界面布局中
45         mainLayout.addWidget(groupBox)
46 
47         #设置主界面布局
48         self.setLayout(mainLayout)
49         #设置主界面标题
50         self.setWindowTitle("checkbox demo")
51 
52     #输出三个复选框当前的状态,0选中,1半选,2没选中
53     def btnstate(self, btn):
54         chk1Status = self.checkBox1.text() + ", isChecked=" + str(self.checkBox1.isChecked()) + ', chekState=' + str(
55             self.checkBox1.checkState()) + "\n"
56         chk2Status = self.checkBox2.text() + ", isChecked=" + str(self.checkBox2.isChecked()) + ', checkState=' + str(
57             self.checkBox2.checkState()) + "\n"
58         chk3Status = self.checkBox3.text() + ", isChecked=" + str(self.checkBox3.isChecked()) + ', checkState=' + str(
59             self.checkBox3.checkState()) + "\n"
60         print(chk1Status + chk2Status + chk3Status)
61 
62 
63 if __name__ == '__main__':
64     app = QApplication(sys.argv)
65     checkboxDemo = CheckBoxDemo()
66     checkboxDemo.show()
67     sys.exit(app.exec_())
View Code

代码分析:

  在这个例子中,将三个复选框添加到一个水平布局管理器中,并添加到一个QGroupBox组中:

groupBox = QGroupBox("Checkboxes")
groupBox.setFlat(False)

  将三个复选框的stateChanged信号都连接到槽函数stateChanged(),使用lambda的方式传递对象给槽函数 
  当QCheckBox状态改变时发射stateChanged信号,当信号发生改变时触发自定义的槽函数btnstate()

self.checkBox1.stateChanged.connect(lambda: self.btnstate(self.checkBox1))
self.checkBox2.toggled.connect(lambda: self.btnstate(self.checkBox2))
self.checkBox3.stateChanged.connect(lambda: self.btnstate(self.checkBox3))

  实例化对象CheckBox1和CheckBox2两个对象,将CheckBox1的状态设置为选中,为CheckBox1设置为快捷键,使用‘&’符号,则可以通过快捷键Alt+C选中checkbox1复选框

self.checkBox1 = QCheckBox("&Checkbox1")
self.checkBox1.setChecked(True)

  使用按钮的isChecked()方法,判断复选框是否被选中,其核心代码是:

chk1Status = self.checkBox1.text() + ", isChecked=" + str(self.checkBox1.isChecked()) + ', chekState=' + str(
            self.checkBox1.checkState()) + "\n"

  实例化一个QCheckBox类的对象checkBox3,然后使用setTristate()开启三态模式,然后设置为半选状态并连接槽函数

self.checkBox3 = QCheckBox("tristateBox")
self.checkBox3.setTristate(True)
self.checkBox3.setCheckState(Qt.PartiallyChecked)
self.checkBox3.stateChanged.connect(lambda: self.btnstate(self.checkBox3))

4、QSlider滑块控件

4.1 简述

  QSlider部件提供了一个垂直或水平滑动条。滑块是一个用于控制有界值的典型部件。它允许用户沿水平或垂直方向移动滑块,并将滑块所在的位置转换成一个合法范围内的值。 

4.2 详细描述

  QSlider很少有自己的函数,大部分功能在QAbstractSlider中。最有用的函数是setValue(),用来设置滑块的当前值;triggerAction()来模拟点击的效果(对快捷键有用),setSingleStep()、setPageStep()用来设置步长,setMinimum()和setMaximum()用于定义滚动条的范围。QSlider提供了一些方法来控制刻度标记。可以使用setTickPosition()来表示刻度标记的位置,使用setTickInterval()来指定刻度的间隔;当前设置的刻度位置和间隔可以分别使用tickPosition()和tickInterval()函数来查询。

4.3 QSlider继承了一组全面的信号

信号 描述
valueChanged() 当滑块的值发生了改变,发射此信号。tracking()确定在用户交互时,是否发出此信号。
sliderPressed() 当用户按下滑块,发射此信号。
sliderMoved() 当用户拖动滑块,发射此信号。
sliderReleased() 当用户释放滑块,发射此信号。

QSlider只提供整数范围。

注意:尽管QSlider可以处理非常大的数字,但是对于用户来说,难以准确使用很大范围的滑块。

滑块接受Tab键的焦点,并同时提供了一个鼠标滚轮和键盘接口。键盘接口如下:

  • Left/Right 移动水平滑块一个步长。
  • Up/Down 移动垂直滑块一个步长。
  • PageUp 上移一页。
  • PageDown 下移一页。
  • Home 移动至起始位置(最小值)。
  • End 移动至结束位置(最大值)

4.4 实例

 1 ##QSlider控件
 2 class Slider(PQW.QWidget):
 3     def __init__(self):
 4         super().__init__()
 5         self.initUI()
 6     def initUI(self):
 7         sld = PQW.QSlider(PQC.Qt.Horizontal,self)
 8         sld.setMinimum(10)
 9         sld.setMaximum(500)
10         sld.setGeometry(30,40,100,30)
11         sld.valueChanged[int].connect(self.changevalue)
12         self.label = PQW.QLabel(self)
13         self.label.setGeometry(160,40,80,30)
14         self.setGeometry(300,300,280,170)
15         self.setWindowTitle('QSlider控件')
16         self.show()
17 
18     def changevalue(self,value):
19         # 在当前位置显示计划快的位置
20         self.label.setText(str(value))
21 
22 if __name__ == '__main__':
23     app = PQW.QApplication(sys.argv)
24     ex = Slider()
25     sys.exit(app.exec_())
View Code

 5、QProgressBar进度条控件

  QProgressBar部件提供了一个水平或垂直进度条。进度条用于给用户操作一个进度指示,并向它们说明应用程序仍在运行。

  可以通过setRange()来设置进度的最小值和最大值(取值范围),也可使用setMinimum()和setMaximum()来单独设定;成员函数setValue()用于设置当前的运行值;调用reset()则会让进度条重新回到开始。

当前值设置完成以后,将显示已完成的百分比,计算百分比的公式为:(value() - minimum()) / (maximum() - minimum())。

如果最小值和最大值都设置为0,进度条会显示一个繁忙指示,而不会显示当前值。有时候这很有用,例如:当使用QNetworkAccessManager下载东西,无法确定被下载项大小时。

可以通过setOrientation()指定进度条的方向 - 水平/垂直。

此外,成员函数setInvertedAppearance()用于设置进度条的行进方向,如果参数为true,可将进度方向设置为默认方向的反方向。

如果不需要显示进度条上的文本,可以使用setTextVisible()来隐藏。

 1 ##QProgressBar进度条控件
 2 class ProgressBar(PQW.QWidget):
 3     def __init__(self):
 4         super().__init__()
 5         self.initUI()
 6     def initUI(self):
 7         self.pbar = PQW.QProgressBar(self)
 8         self.pbar.setGeometry(40,40,200,25)
 9         self.btn = PQW.QPushButton('开始',self)
10         self.btn.move(40,80)
11         self.btn.clicked.connect(self.doAction)
12 
13         self.timer = PQC.QBasicTimer()
14         self.value = 0
15         self.setGeometry(300,300,280,270)
16         self.setWindowTitle('QProgressBar控件')
17         self.show()
18 
19     def timerEvent(self, e):
20         if self.value >=100:
21             self.timer.stop()
22             self.btn.setText('完成')
23             return
24         self.value = self.value +1
25         self.pbar.setValue(self.value)
26 
27     def doAction(self):
28         if self.value>=100:
29             self.value = 0
30             self.btn.setText('开始')
31             
32         if self.timer.isActive():
33             self.timer.stop()
34             self.btn.setText('开始')
35         else:
36             self.timer.start(100,self)
37             self.btn.setText('停止')
38 
39 if __name__ == '__main__':
40     app = PQW.QApplication(sys.argv)
41     ex = ProgressBar()
42     sys.exit(app.exec_())
View Code

 在我们的例子,我们有一个水平进度条控件和一个按钮控件。点击按钮启动或停止进度条。

self.pbar = QProgressBar(self)          使用 QProgressBar 创建进度条

self.timer = QBasicTimer()                激活进度条,我们需使用一个计时器对象。

self.timer.start(100, self)                  要启动定时器事件,我们需调用它的start()方法。这种方法有两个参数:超时和将接收的事件的对象。

def timerEvent(self, e):    #  每个继承自QObject 的对象都有一个timerEvent()事件处理程序。为了定时器事件作用到进度条,我们重写了这个事件处理程序。

def doAction(self, value):    # 使用 doAction() 方法启动和停止计时器。

 6、QPixmap图像显示控件

  QPixmap类用于绘图设备的图像显示,它可以作为一个QPainterDevice对象,也可以加载到一个控件中,通常是标签或者按钮,用于在标签或按钮上显示图像 。QPixmap可以读取的图像文件类型有BMP,GIF,JPG等。通过QPixmap类的构造方法可以指定要显示的图像文件名。

  QPixmap类中常用的方法:

方法 描述
copy() 从QRect对象复制到QPixmap对象
fromImage() 将QImage对象转换为QPixmap对象
grabWidget() 从给定的一个窗口小控件创建一个像素图
grabWindow() 在窗口创建数据的像素图
load() 加载图像文件作为QPixmap对象
save() 将QPixmap对象保存为文件
toImage() 将QPixmap对象转换为QImage对象

  实例:

 1 class Pixmap(PQW.QWidget):
 2     def __init__(self):
 3         super().__init__()
 4         self.initUI()
 5     def initUI(self):
 6         hbox = PQW.QHBoxLayout(self)
 7         pixmap = PQG.QPixmap('timg.jpg')
 8         lbl = PQW.QLabel(self)
 9         lbl.setPixmap(pixmap)
10         hbox.addWidget(lbl)
11         self.setLayout(hbox)
12         self.move(300,200)
13         self.setWindowTitle('显示图像(QPixmap控件)')
14         self.show()
15 
16 if __name__ == '__main__':
17     app = PQW.QApplication(sys.argv)
18     ex = Pixmap()
19     sys.exit(app.exec_())
View Code

 7、QComboBox控件

7.1 简单实例:

 1 ## QComboBox控件
 2 # mylist = ['中国','美国','法国','俄罗斯','澳大利亚']
 3 class ComboBox(PQW.QWidget):
 4     def __init__(self):
 5         super().__init__()
 6         self.initUI()
 7 
 8     def initUI(self):
 9         self.lbl = PQW.QLabel('中国',self)
10         self.lbl.move(50, 150)
11         combo = PQW.QComboBox(self)
12         # combo.addItems(mylist)
13         combo.addItem('中国')
14         combo.addItem('美国')
15         combo.addItem('法国')
16         combo.addItem('德国')
17         combo.addItem('俄罗斯')
18         combo.addItem('澳大利亚')
19         combo.move(50,50)
20         combo.activated[str].connect(self.onActivated)
21         combo1 = PQW.QComboBox(self)
22         combo1.addItem('Item1')
23         combo1.addItem('Item2')
24         combo1.addItem('Item3')
25         combo1.move(200,50)
26         self.setGeometry(300,300,300,200)
27         self.setWindowTitle('QComboBox控件')
28         self.show()
29     def onActivated(self,str):
30         self.lbl.setText(str)
31         self.lbl.adjustSize()
32 
33 if __name__ == '__main__':
34     app = PQW.QApplication(sys.argv)
35     ex = ComboBox()
36     sys.exit(app.exec_())
View Code

 

7.2 控件详解:

QComboBox 的常规使用方法,在这个使用模板里,基本都有了。

QComboBox小部件是一个组合的按钮和弹出列表。

QComboBox提供了一种向用户呈现选项列表的方式,其占用最小量的屏幕空间。

组合框是一个显示当前项目的选择小部件,可以弹出可选项目列表。组合框可以是可编辑的,允许用户修改列表中的每个项目。

组合框可以包含图像以及字符串; 当然insertItem()和setItemText()函数需要适当重载。对于可编辑组合框,提供了函数clearEditText(),以清除显示的字符串而不更改组合框的内容。

如果组合框的当前项目发生更改,则会发出两个信号currentIndexChanged()和activated()。无论以编程方式或通过用户交互完成更改,currentIndexChanged()总是被发射,而只有当更改是由用户交互引起时才activated() 。highlighted()信号在用户突出显示组合框弹出列表中的项目时发出。所有三个信号都有两个版本,一个带有str参数,另一个带有int参数。如果用户选择或突出显示一个图像,则只会发出int信号。每当可编辑组合框的文本发生改变时,editTextChanged()信号就会发出。

当用户在可编辑的组合框中输入一个新的字符串时,该小部件可能会插入它,也可能不会插入它,并且可以将它插入到多个位置。默认策略是InsertAtBottom,但您可以使用setInsertPolicy()更改它。

可以使用QValidator将输入约束为可编辑的组合框;请参阅setValidator()。默认情况下,接受任何输入。

例如,可以使用插入函数insertItem()和insertItems()来填充组合框。可以使用setItemText()更改项目。一个项目可以使用removeItem()来移除,所有项目都可以使用clear()来移除。当前项目的文本由currentText()返回,项目的文本编号使用text()返回。当前项目可以使用setCurrentIndex()来设置。 count()返回组合框中的项目数;可以用setMaxCount()设置项目的最大数量。您可以允许使用setEditable()进行编辑。对于可编辑组合框,您可以使用setCompleter()设置自动完成,并且用户是否可以添加重复项由setDuplicatesEnabled()进行设置。

QComboBox为其弹出列表使用模型/视图框架并存储其项目。默认情况下,QStandardItemModel存储项目,QListView子类显示弹出列表。您可以直接访问模型和视图(使用model()和view()),但QComboBox还提供了设置和获取项目数据的函数(例如,setItemData()和itemText())。您还可以设置新的模型和视图(使用setModel()和setView())。对于组合框标签中的文本和图标,将使用具有Qt.DisplayRole和Qt.DecorationRole的模型中的数据。请注意,您不能通过使用setSelectionMode()来更改view()的SelectionMode。

类归属

PyQt5->QtWidgets->QComboBox

继承关系

PyQt5->QObject and QPaintDevice->QWidget->QFontComboBox->QComboBox

熟悉一下代码,直接就可以用了。

7.3 实例代码

  1 ##ComboBox(二)
  2 import sys
  3 from PyQt5.QtWidgets import *
  4 from PyQt5.QtGui import *
  5 from PyQt5.QtCore import *
  6 ################################################
  7 
  8 items_list=["C","C++","Java","Python","JavaScript","C#","Swift","go","Ruby","Lua","PHP"]
  9 
 10 datas_list=[1972,1983,1995,1991,1992,2000,2014,2009,1995,1993,1995]
 11 
 12 
 13 ################################################
 14 class Widget(QWidget):
 15     def __init__(self, *args, **kwargs):
 16         super(Widget, self).__init__(*args, **kwargs)
 17         layout = QVBoxLayout(self)
 18         self.combobox1 = QComboBox(self, minimumWidth=200)
 19         self.combobox2 = QComboBox(self, minimumWidth=200)
 20         self.combobox3 = QComboBox(self, minimumWidth=200)
 21         self.combobox4 = QComboBox(self, minimumWidth=200)
 22 
 23         layout.addWidget(QLabel("增加单项,不带数据", self))
 24         layout.addWidget(self.combobox1)
 25         layout.addItem(QSpacerItem(20, 20, QSizePolicy.Expanding, QSizePolicy.Minimum))
 26 
 27         layout.addWidget(QLabel("增加单项,附带数据", self))
 28         layout.addWidget(self.combobox2)
 29         layout.addItem(QSpacerItem(20, 20, QSizePolicy.Expanding, QSizePolicy.Minimum))
 30 
 31         layout.addWidget(QLabel("增加多项,不带数据", self))
 32         layout.addWidget(self.combobox3)
 33         layout.addItem(QSpacerItem(20, 20, QSizePolicy.Expanding, QSizePolicy.Minimum))
 34 
 35         layout.addWidget(QLabel("设置模型,不带数据", self))
 36         layout.addWidget(self.combobox4)
 37 
 38 
 39         #初始化combobox
 40         self.init_combobox1()
 41         self.init_combobox2()
 42         self.init_combobox3()
 43         self.init_combobox4()
 44 
 45         #增加选中事件
 46         self.combobox1.activated.connect(self.on_combobox1_Activate)
 47         self.combobox2.activated.connect(self.on_combobox2_Activate)
 48         self.combobox3.activated.connect(self.on_combobox3_Activate)
 49         self.combobox4.activated.connect(self.on_combobox4_Activate)
 50 
 51 
 52 
 53 
 54     ####### addItem()  增加单项元素,不带数据  #########
 55     def init_combobox1(self):
 56         for i in range(len(items_list)):
 57             self.combobox1.addItem(items_list[i])
 58         self.combobox1.setCurrentIndex(-1)
 59 
 60     def on_combobox1_Activate(self, index):
 61         print(self.combobox1.count())
 62         print(self.combobox1.currentIndex())
 63         print(self.combobox1.currentText())
 64         print(self.combobox1.currentData())
 65         print(self.combobox1.itemData(self.combobox1.currentIndex()))
 66         print(self.combobox1.itemText(self.combobox1.currentIndex()))
 67         print(self.combobox1.itemText(index))
 68 
 69     ####### addItem()  增加单项元素,附带数据  #########
 70     def init_combobox2(self):
 71         for i in range(len(items_list)):
 72             self.combobox2.addItem(items_list[i],datas_list[i])
 73         self.combobox2.setCurrentIndex(-1)
 74 
 75     def on_combobox2_Activate(self, index):
 76         print(self.combobox2.count())
 77         print(self.combobox2.currentIndex())
 78         print(self.combobox2.currentText())
 79         print(self.combobox2.currentData())
 80         print(self.combobox2.itemData(self.combobox2.currentIndex()))
 81         print(self.combobox2.itemText(self.combobox2.currentIndex()))
 82         print(self.combobox2.itemText(index))
 83 
 84 
 85     ####### addItems()  增加多项元素,不带数据  #########
 86     def init_combobox3(self):
 87         self.combobox3.addItems(items_list)
 88         self.combobox3.setCurrentIndex(-1)
 89 
 90     def on_combobox3_Activate(self, index):
 91         print(self.combobox3.count())
 92         print(self.combobox3.currentIndex())
 93         print(self.combobox3.currentText())
 94         print(self.combobox3.currentData())
 95         print(self.combobox3.itemData(self.combobox3.currentIndex()))
 96         print(self.combobox3.itemText(self.combobox3.currentIndex()))
 97         print(self.combobox3.itemText(index))
 98 
 99     ####### setModel()  设置数据模型,不带数据  #########
100     def init_combobox4(self):
101         self.tablemodel = QStringListModel(items_list)
102         self.combobox4.setModel(self.tablemodel)
103         self.combobox4.setCurrentIndex(-1)
104 
105     def on_combobox4_Activate(self, index):
106         print(self.combobox4.count())
107         print(self.combobox4.currentIndex())
108         print(self.combobox4.currentText())
109         print(self.combobox4.currentData())
110         print(self.combobox4.itemData(self.combobox4.currentIndex()))
111         print(self.combobox4.itemText(self.combobox4.currentIndex()))
112         print(self.combobox4.itemText(index))
113 
114 if __name__ == "__main__":
115     app = QApplication(sys.argv)
116     w = Widget()
117     w.show()
118     sys.exit(app.exec_())
View Code

 8、QCalendarWidget控件

  QCalendarWidget控件适用于显示日历的控件,可以按年月显示日历,通过setGridVisible方法可以设置是否在日期中显示网格,通过绑定clicked事件,可处理单击日历某一天的动作。

 1 ##QCalendarWidget控件
 2 class CalendarWidget(PQW.QWidget):
 3     def __init__(self):
 4         super().__init__()
 5         self.initUI()
 6     def initUI(self):
 7         vbox = PQW.QVBoxLayout(self)
 8         cal =PQW.QCalendarWidget(self)
 9         cal.setGridVisible(True)
10         cal.clicked[PQC.QDate].connect(self.showDate)
11         vbox.addWidget(cal)
12         self.lbl = PQW.QLabel(self)
13         date = cal.selectedDate()
14         self.lbl.setText(date.toString())
15         vbox.addWidget(self.lbl)
16         self.setLayout(vbox)
17         self.setGeometry(300,300,350,300)
18         self.setWindowTitle('CalendarWidget控件')
19         self.show()
20 
21     def showDate(self,date):
22         self.lbl.setText(date.toString())
23 
24 if __name__ == '__main__':
25     app = PQW.QApplication(sys.argv)
26     ex = CalendarWidget()
27     sys.exit(app.exec_())
View Code

 运行效果:

PyQt5:常用控件_第8张图片  

转载于:https://www.cnblogs.com/chenhaiming/p/9929252.html

你可能感兴趣的:(PyQt5:常用控件)