PyQt5：常用控件

阅读量：5920 次

发布时间：2019-06-19

本文共 32899 字，大约阅读时间需要 109 分钟。

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 sysimport PyQt5.QtWidgets as PQWimport 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         #创建按钮114         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         #创建按钮228         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或False56         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	当编辑文本结束时，这个信号就会发射

　　定义输入掩码的字符

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

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

　　掩码示例如下：

掩码	注意事项
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

显示效果：

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

实例二、验证器

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-9934         pIntvalidator=QIntValidator(self)35         pIntvalidator.setRange(1,99)36 37         #浮点型 范围 【-360,360】，精度小数点后两位38         #实例化浮点验证器，设置范围-360到36039         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

显示效果：

实例三、输入掩码

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

显示效果：

实例四：综合实例

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

显示效果：

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 = 015         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             return24         self.value = self.value +125         self.pbar.setValue(self.value)26 27     def doAction(self):28         if self.value>=100:29             self.value = 030             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

运行效果：