8 按钮类控件
《PyQt5快速开发与实战》学习笔记。
8.1 QAbstractButton
在任何 GUI 设计中，按钮都是最重要的和常用的触发动作请求的方式，用来与用户进行交互操作。在 PyQt5 中根据不同的使用场景将按钮划分为不同的表现形式。按钮的基类是 QAbstractButton，提供了按钮的通用性功能。QAbstractButton 类为抽象类，不能实例化，必须由其他的按钮类继承 QAbstractButton 类，来实现不同的功能、不同的表现形式。
常见的按钮类包括：QPushButton、QToolButton、QRadioButton 和 QCheckBox。这些按钮类均继承自 QAbstractButton 类，根据各自的使用场景通过图形展现出来。
QAbstractButton 提供的状态如下所示：
QAbstractButton 提供的信号如下所示：
8.2 QPushButton
QPushButton 类继承自 QAbstractButton 类，其形状是长方形，文本标题或图标可以显示在其上。它也是一种命令按钮，可以单击该按钮执行一些命令，或者响应一些事件。
命令按钮通常通过文本来描述执行的动作，有时候也会通过快捷键来执行对应按钮的命令。
QPushButton 类中的常用方法：
通过按钮名字能为 QPushButton 设置快捷键，比如名字为“&Download”的按钮，它的快捷键是“Alt+D”。其规则是：如果想要实现快捷键为“Alt + D”，那么按钮的名字里就要有这个字母 D，并且在字母 D 前面加上“&”。这个字母 D 一般是按钮名称的首字母，而且在按钮显示时，“&” 不会被显示出来，但字母 D 会显示一条下画线。如果只想显示 “&”，那么需要像转义一样使用 “&&”。更多的关于快捷键的使用，请参考 QShortcut 类。其核心代码如下：
self.button=QPushButton("&Download")
self.button.setDefault(True)
一个例子：
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(QPixmap("./images/python.png")))
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__':
app = QApplication(sys.argv)
btnDemo = Form()
btnDemo.show()
sys.exit(app.exec_())
8.3 QRadioButton
QRadioButton 类继承自 QAbstractButton 类，它提供了一组可供选择的按钮和文本标签，用户可以选择其中一个选项，标签用于显示对应的文本信息。单选钮是一种开关按钮，可以切换为 on 或者off，即 checked 或者 unchecked，主要是为用户提供“多选一”的选择。
QRadioButton 是单选钮控件默认是独占的（Exclusive）。对于继承自同一个父类 Widget 的多个单选钮，它们属于同一个按钮组合，在单选钮组里，一次只能选择一个单选钮。如果需要多个独占的按钮组合，则需要将它们放在 QGroupBox 或 QButtonGroup 中。
当将单选钮切换到 on 或者 off 时，就会发送 toggled 信号，绑定这个信号，在按钮状态发生改变时，触发相应的行为。
QRadioButton类中的常用方法：
在 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__':
app = QApplication(sys.argv)
radioDemo = Radiodemo()
radioDemo.show()
sys.exit(app.exec_())
效果：
8.4 QCheckBox
QCheckBox 类继承自 QAbstractButton 类，它提供了一组带文本标签的复选框，用户可以选择多个选项。和 QPushButton 一样，复选框可以显示文本或者图标，其中文本可以通过构造函数或者 setText() 来设置；图标可以通过 setIcon() 来设置。在视觉上，QButtonGroup 可以把许多复选框组织在一起。
QCheckBox（复选框）和 QRadioButton（单选钮）都是选项按钮，因为它们都可以在开（选中）或者关（未选中）之间切换。它们的区别是对用户选择的限制：单选钮提供了“多选一”的选择；而复选框提供的是“多选多”的选择。
QCheckBox 通常被应用在需要用户选择一个或多个可用的选项的场景中。只要复选框被选中或者取消选中，都会发射一个 stateChanged 信号。如果想在复选框状态改变时触发相应的行为，请连接这个信号，可以使用 isChecked() 来查询复选框是否被选中。
除了常用的选中和未选中两种状态，QCheckBox 还提供了第三种状态（半选中）来表明“没有变化”。当需要为用户提供一个选中或者未选中复选框的选择时，这种状态是很有用的。如果需要第三种状态，则可以通过 setTristate() 来使它生效，并使用 checkState() 来查询当前的切换状态。
QCheckBox 类中的常用方法：
三态复选框有三种状态：
QCheckBox 按钮的使用
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(False)
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("tristateBox")
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()+", isChecked=" + str(self.checkBox1.isChecked()) + \
', chekState=' + str(self.checkBox1.checkState()) + "\n"
chk2Status = self.checkBox2.text()+", isChecked=" + str(self.checkBox2.isChecked()) + \
', checkState=' + str(self.checkBox2.checkState()) + "\n"
chk3Status = self.checkBox3.text()+", isChecked=" + str(self.checkBox3.isChecked()) + \
', checkState=' + str(self.checkBox3.checkState()) + "\n"
print(chk1Status + chk2Status + chk3Status)
if __name__ == '__main__':
app = QApplication(sys.argv)
checkboxDemo = CheckBoxDemo()
checkboxDemo.show()
sys.exit(app.exec_())
效果：