PyQt5 GUI编程——QCheckBox

最新推荐文章于 2026-04-25 02:18:45 发布

原创

最新推荐文章于 2026-04-25 02:18:45 发布 · 3.2k 阅读

本文介绍了PyQt5中的QCheckBox类，它作为QAbstractButton的子类，用于创建带有文本标签的多选复选框。QCheckBox支持设置文本和图标，并通过QButtonGroup组织视觉上的布局。QCheckBox与QRadioButton的主要区别在于其多选多的特性。当状态改变时，会触发stateChanged信号。此外，QCheckBox还支持三态切换，包括全选、未选和半选状态，通过setTristate()启用，并使用checkState()查询状态。文中还列举了QCheckBox的常用方法并给出应用实例。

QCheckBox类继承自QAbstractButton类，它提供了一组带文本标签的复选框，用户可以选择多个选项。和QPushButton一样，复选框可以显示文本或者图标，其中文本可以通过构造函数或者setText()来设置，图标可以通过setIcon()来设置。在视觉上，QButtonGroup可以把许多复选框组织在一起。
QCheckBox（复选框）和QRadioButton（单选钮）都是选项按钮，它们的区别在于单选钮为多选一，而复选框为多选多。QCheckBox通常被应用于需要用户选择一个或多个的选项的场景中。
只要复选框被选中或者被取消选中，都会发射一个stateChanged信号。除了常用的选中和未选中两种状态，QCheckBox还提供了第三种状态（半选中）来表示“没有变化”。当需要为用户提供一个选中或者未选中复选框的选择时，这种状态是很有用的。如果需要第三种状态，则可以通过setTristate()来使它生效，并使用checkState()来查询当前的切换状态。
QCheckBox类的常用方法如下：
在这里插入图片描述
三态复选框有三种状态，如下所示：

应用实例如下：

import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *

class CheckBoxDemo(QWidget):
	def __init__(self,parent=None):
		super().__init__(parent)
		
		groupBox = QGroupBox("Checkboxes")
		#去除groupBox的边框
		groupBox.setFl