PyQt5 - 三态复选框

简介

在PyQt5中，三态复选框是QCheckBox的一种特殊形式。它不仅可以被选中和未选中，还可以处于第三种状态：未知。

在某些情况下，三态复选框可以提供更好的用户体验，例如：

• 当某个选项既不确定选中也不确定未选中时
• 当多个选项切换到一个新状态时

实现

要创建三态复选框，只需在QCheckBox的构造函数中将三态状态参数设置为True，如下所示：

checkBox = QCheckBox('Option A')
checkBox.setTristate(True)

默认情况下，三态复选框处于未知状态。要设置为选中或未选中状态，请使用setChecked方法：

checkBox.setCheckState(Qt.Checked)   # 选中状态
checkBox.setCheckState(Qt.Unchecked) # 未选中状态

但是，对于第三种状态，三态复选框没有相应的方法。要设置为未知状态，必须使用setCheckState方法的以下语法：

checkBox.setCheckState(Qt.PartiallyChecked) # 未知状态

在三态复选框中检查当前状态，可以使用checkState方法，它将返回三个常量之一：

checked = Qt.Checked           # 选中状态
unchecked = Qt.Unchecked       # 未选中状态
partiallyChecked = Qt.PartiallyChecked # 未知状态

示例代码

from PyQt5.QtWidgets import QApplication, QWidget, QCheckBox, QVBoxLayout
from PyQt5.QtCore import Qt


class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):

        vbox = QVBoxLayout()

        checkBox = QCheckBox('Option A')
        checkBox.setTristate(True)  # 设置为三态复选框
        checkBox.stateChanged.connect(self.changeState) # 绑定状态更改信号

        vbox.addWidget(checkBox)

        self.setLayout(vbox)

        self.setGeometry(300, 300, 300, 200)
        self.setWindowTitle('PyQt5 - 三态复选框')
        self.show()

    def changeState(self, state):
        print('当前状态:', state)


if __name__ == '__main__':
    app = QApplication([])
    ex = Example()
    app.exec_()

以上代码将创建一个简单的窗口，其中包含三态复选框，每次更改其状态时将调用changeState方法，并将其状态打印到控制台。

总结

三态复选框是PyQt5中QCheckBox的特殊形式。它提供了三种状态：选中、未选中和未知。在某些情况下，三态复选框可以提供更好的用户体验。要创建三态复选框，请在QCheckBox的构造函数中将三态状态参数设置为True。检查当前状态时，可以使用checkState方法。对于第三种状态，使用setCheckedState方法设置为Qt.PartiallyChecked。