在任何GUI设计中,按钮都是最重要的和常用的触发动作请求的方式,用来与用户进行交互操作。在PyQt中根据不同的使用场景将按钮划分为不同的表现形式。按钮的基类是QAbstractButton,提供了按钮的通用性功能。QAbstractButton类为抽象类,不能实例化,必须由其他的按钮类继承QAbstractButton类,来实现不同的功能、不同的表现形式。
常见的按钮类:
QAbstractButton提供的状态:
状态 | 含义 |
---|---|
isDown() | 提示按钮是否被按下 |
isChecked() | 提示按钮是否已经标记 |
isEnable() | 提示按钮是否可以被用户点击 |
isCheckAble() | 提示按钮是否为可标记的 |
setAutoRepeat() | 设置按钮是否在用户长按时可以自动重复执行 |
QAbstractButton提供的信号:
信号 | 含义 |
---|---|
Pressed | 当鼠标指针在按钮上并按下左键时触发信号 |
Released | 当鼠标左键被释放时触发该信号 |
Clicked | 当鼠标左键被按下然后释放时,或者快捷键被释放时触发该信号 |
Toggled | 当按钮的标记状态发生改变时触发该信号 |
QPushButton类继承自QAbstractButton类,其形状是长方形,文本标题或图标可以显示在长方形上。它也是一种命令按钮,可以单击该按钮执行一些命令,或者响应一些事件。常见的有“确认”“申请”“取消”“关闭”“是”“否”等按钮。
命令按钮通常通过文本来描述执行的动作,有时候也会通过快捷键来执行对应按钮的命令。
QPushButton类中的常用方法
方法 | 描述 |
---|---|
setCheckable() | 设置按钮是否已经被选中,如果设置为True,则表示按钮将保持已点击和释放状态 |
toggle() | 在按钮状态之间进行切换 |
setIcon() | 设置按钮上的图标 |
setEnabled() | 设置按钮是否可以使用,当设置为False时,按钮变成不可用状态,点击它不会发射信号 |
isChecked() | 返回按钮的状态。返回值为True或False |
setDefault() | 设置按钮的默认状态 |
setText() | 设置按钮的显示文本 |
text() | 返回按钮的显示文本 |
为QPushButton设置快捷键
通过按钮名字能为 QPushButton设置快捷键,比如名字为“&Download”的按钮,它的快捷键是“Alt+D”。
import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
class Form(QDialog):
def __init__(self,parent = None):
super(Form, self).__init__(parent)
layout = QVBoxLayout()
self.btn1 = QPushButton("Button1")
self.btn1.setCheckable(True)
self.btn1.toggle() ## 切换按钮状态
self.btn1.clicked.connect(lambda : self.whichbtn(self.btn1))
self.btn1.clicked.connect(self.btnstate)
layout.addWidget(self.btn1)
self.btn2 = QPushButton('image')
self.btn2.setIcon(QIcon("../打包资源文件/pic/python.jpg"))
self.btn2.clicked.connect(lambda : self.whichbtn(self.btn2))
layout.addWidget(self.btn2)
self.setLayout(layout)
self.btn3 = QPushButton("Disabled")
self.btn3.setEnabled(False)
layout.addWidget(self.btn3)
self.btn4 = QPushButton('&Download')
self.btn4.setDefault(True)
self.btn4.clicked.connect(lambda : self.whichbtn(self.btn4))
layout.addWidget(self.btn4)
self.setWindowTitle("Button Demo")
def btnstate(self):
if self.btn1.isChecked():
print("Button pressed")
else:
print("Button released")
def whichbtn(self,btn):
print("Clicked button is " + btn.text())
if __name__ == '__main__':
from pyqt5_plugins.examples.exampleqmlitem import QtCore
QtCore.QCoreApplication.setAttribute(QtCore.Qt.AA_EnableHighDpiScaling)
app = QApplication(sys.argv)
win = Form()
win.show()
sys.exit(app.exec_())
QRadioButton类继承自QAbstractButton类,它提供了一组可供选择的按钮和文本标签,用户可以选择其中一个选项,标签用于显示对应的文本信息。单选钮是一种开关按钮,可以切换为on或者off,即 checked或者unchecked,主要是为用户提供“多选一”的选择。
ORadioButton是单选钮控件默认是独占的(Exclusive)。对于继承Widget的多个单选钮,它们属于同一个按钮组合,在单选钮组里,一次只能选择一个单选钮。如果需要多个独占的按钮组合,则需要将它们放在QGroupBox或QButtonGroup 中。
当将单选钮切换到on或者off 时,就会发送 toggled信号,绑定这个信号,在按钮状态发生改变时,触发相应的行为。
QRadioButton类的常用方法
方法 | 描述 |
---|---|
setCheckable() | 设置按钮是否已经被选中,可以改变单选钮的选中状态,如果设置为 True,则表示单选钮将保持己点击和释放状态 |
isChecked() | 返回单选钮的状态。返回值为True或 False |
setText() | 设置单选按钮的显示文本 |
text() | 返回单选按钮的显示文本 |
在 QRadioButton中,toggled信号是在切换单选钮状态(开、关)时发射的,而clicked信号则在每次点击单选钮时都会发射。在实际中,一般只有状态改变时才有必要去响应,因此toggled信号更适合用于状态监控。
import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
class Radiodemo(QWidget):
def __init__(self,parent = None):
super(Radiodemo, self).__init__(parent)
layout = QHBoxLayout()
self.btn1 = QRadioButton("Button1")
self.btn1.setChecked(True)
self.btn1.toggled.connect(lambda : self.btnstate(self.btn1))
layout.addWidget(self.btn1)
self.btn2 = QRadioButton("Button2")
self.btn2.toggled.connect(lambda :self.btnstate(self.btn2))
layout.addWidget(self.btn2)
self.setLayout(layout)
self.setWindowTitle("RadioButton Demo")
def btnstate(self,btn):
if btn.text() == "Button1":
if btn.isChecked() == True:
print(btn.text() + "is selected")
else:
print(btn.text() + "is deselected")
if btn.text() == "Button2":
if btn.isChecked() == True:
print(btn.text() + "is selected")
else:
print(btn.text() + "is deselected")
if __name__ == '__main__':
from pyqt5_plugins.examples.exampleqmlitem import QtCore
QtCore.QCoreApplication.setAttribute(QtCore.Qt.AA_EnableHighDpiScaling)
app = QApplication(sys.argv)
win = Radiodemo()
win.show()
sys.exit(app.exec_())
QCheckBox类继承自QAbstractButton类,它提供了一组带文本标签的复选框,用户可以选择多个选项。和QPushButton一样,复选框可以显示文本或者图标,其中文本可以通过构造函数或者 setText()来设置;图标可以通过 setIcon()来设置。在视觉上,QButtonGroup可以把许多复选框组织在一起。
OCheckBox(复选框)和 QRadioButton(单选钮)都是选项按钮,因为它们都可以在开(选中)或者关(未选中)之间切换。它们的区别是对用户选择的限制:单选钮提供了“多选一”的选择;而复选框提供的是“多选多”的选择。
QCheckBox通常被应用在需要用户选择一个或多个可用的选项的场景中。只要复选框被选中或者取消选中,都会发射一个stateChanged信号。如果想在复选框状态改变时触发相应的行为,请连接这个信号,可以使用isChecked()来查询复选框是否被选中。
除了常用的选中和未选中两种状态,OCheckBox还提供了第三种状态(半选中)来表明“没有变化”。当需要为用户提供一个选中或者未选中复选框的选择时,这种状态是很有用的。如果需要第三种状态,则可以通过setTristate()来使它生效,并使用checkState()来查询当前的切换状态。
QCheckBox类中的常用方法
方法 | 描述 |
---|---|
setChecked() | 设置复选框的状态,设置为True时表示选中复选框,设置为 False时表示取消选中复选框 |
setText() | 设置复选框的显示文本 |
text() | 返回复选框的显示文本 |
isChecked() | 检查复选框是否被选中 |
setTristate() | 设置复选框为一个三态复选框 |
三态复选框有三种状态:
名称 | 值 | 含义 |
---|---|---|
Qt.Checked | 2 | 组件没有被选中(默认) |
Qt.PartiallyChecked | 1 | 组件被半选中 |
Qt.Unchecked | 0 | 组件被选中 |
import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
from PyQt5.QtCore import Qt
class CheckBoxDemo(QWidget):
def __init__(self,parent = None):
super(CheckBoxDemo, self).__init__(parent)
groupBox = QGroupBox("Checkboxes")
groupBox.setFlat(True)
layout = QHBoxLayout()
self.checkBox1 = QCheckBox('&Checkbox1')
self.checkBox1.setChecked(True)
self.checkBox1.stateChanged.connect(lambda : self.btnstate(self.checkBox1))
layout.addWidget(self.checkBox1)
self.checkBox2 = QCheckBox("Checkbox2")
self.checkBox2.toggled.connect(lambda : self.btnstate(self.checkBox2))
layout.addWidget(self.checkBox2)
self.checkBox3 = QCheckBox("Checkbox3")
self.checkBox3.setTristate(True)
self.checkBox3.setCheckState(Qt.PartiallyChecked)
self.checkBox3.stateChanged.connect(lambda :self.btnstate(self.checkBox3))
layout.addWidget(self.checkBox3)
groupBox.setLayout(layout)
mainLayout = QVBoxLayout()
mainLayout.addWidget(groupBox)
self.setLayout(mainLayout)
self.setWindowTitle("CheckBox demo")
def btnstate(self,btn):
chk1Status = self.checkBox1.text() + ",is checked = " + str(self.checkBox1.isChecked()) + ',checkstate = ' + str(self.checkBox1.checkState()) + "\n"
chk2Status = self.checkBox2.text() + ",is checked = " + str(self.checkBox2.isChecked()) + ',checkstate = ' + str(self.checkBox2.checkState()) + "\n"
chk3Status = self.checkBox3.text() + ",is checked = " + str(self.checkBox3.isChecked()) + ',checkstate = ' + str(self.checkBox3.checkState()) + "\n"
print(chk1Status + chk2Status + chk3Status)
if __name__ == '__main__':
from pyqt5_plugins.examples.exampleqmlitem import QtCore
QtCore.QCoreApplication.setAttribute(QtCore.Qt.AA_EnableHighDpiScaling)
app = QApplication(sys.argv)
win = CheckBoxDemo()
win.show()
sys.exit(app.exec_())
QComboBox是一个集按钮和下拉选项于一体的控件,也被称为下拉列表框。
方法 | 描述 |
---|---|
addItem() | 添加一个下拉选项 |
addItems() | 从列表中添加下拉选项 |
Clear() | 删除下拉选项集合中的所有选项 |
count() | 返回下拉选项集合中的数目 |
currentText() | 返回选中选项的文本 |
itemText(i) | 获取索引为i的 item的选项文本 |
currentIndex() | 返回选中项的索引 |
setItemText(int index,text) | 改变序号为index项的文本 |
信号 | 含义 |
---|---|
Activated | 当用户选中一个下拉选项时发射该信号 |
currentIndexChanged | 当下拉选项的索引发生改变时发射该信号 |
highlighted | 当选中一个已经选中的下拉选项时,发射该信号 |
import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
class ComboxDemo(QWidget):
def __init__(self,parent = None):
super(ComboxDemo, self).__init__(parent)
self.setWindowTitle("ComBox案例")
self.resize(300 , 90)
layout = QVBoxLayout()
self.lb1 = QLabel("")
self.cb = QComboBox()
self.cb.addItem("C")
self.cb.addItem("C++")
self.cb.addItems(["Java","C#","Python"])
self.cb.currentIndexChanged.connect(self.selectionchange)
layout.addWidget(self.cb)
layout.addWidget(self.lb1)
self.setLayout(layout)
def selectionchange(self,i):
self.lb1.setText(self.cb.currentText())
print("Item in the list are:")
for count in range(self.cb.count()):
print("Item" + str(count) + "=" + self.cb.itemText(count))
print("Current index",i , "selection changed",self.cb.currentText())
if __name__ == '__main__':
from pyqt5_plugins.examples.exampleqmlitem import QtCore
QtCore.QCoreApplication.setAttribute(QtCore.Qt.AA_EnableHighDpiScaling)
app = QApplication(sys.argv)
win = ComboxDemo()
win.show()
sys.exit(app.exec_())