复选框通过QCheckBox实现，可设置状态并响应变化。创建后可用setChecked设置默认状态，通过stateChanged信号连接槽函数处理交互，支持多选项分别响应。
PyQt5 中的复选框使用 QCheckBox 类来实现，常用于让用户选择一个或多个选项。下面介绍如何创建和使用复选框，并响应其状态变化。
创建基本复选框
你可以通过实例化 QCheckBox 并设置父窗口来添加复选框：
from PyQt5.QtWidgets import QApplication, QWidget, QCheckBox, QVBoxLayout
import sys
<p>app = QApplication(sys.argv)
window = QWidget()
layout = QVBoxLayout()</p><h1>创建复选框</h1><p>checkbox = QCheckBox("同意用户协议")</p><p>layout.addWidget(checkbox)
window.setLayout(layout)
window.show()</p><p>sys.exit(app.exec_())</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记（深入）</a>”；</p>获取和设置复选框状态
复选框有三种状态：未选中（Unchecked）、选中（Checked）和部分选中（Partially Checked），可以通过以下方法操作：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- isChecked()：返回布尔值，判断是否被选中
- setChecked(True/False)：设置是否选中
- setCheckState(state)：设置状态，如 Qt.Checked、Qt.Unchecked、Qt.PartiallyChecked
示例：设置默认选中
checkbox.setChecked(True) # 默认选中
响应复选框状态变化
使用 stateChanged 信号来监听复选框的变化，连接到槽函数处理逻辑：
def on_checkbox_changed(state):
if state == 2: # Qt.Checked 的值是 2
print("已同意协议")
else:
print("未同意协议")
<p>checkbox.stateChanged.connect(on_checkbox_changed)
</font></p>注意：state 参数是整数，对应关系如下：
- 0：未选中（Qt.Unchecked）
- 1：部分选中（Qt.PartiallyChecked）— 多用于树形控件中的中间状态
- 2：选中（Qt.Checked）
多个复选框的处理
如果有多个复选框，可以分别连接信号，或通过名称判断来源：
def on_check_change(state):
cb = window.sender() # 获取触发信号的复选框
print(f"{cb.text()} 状态改变为: {state}")
<p>cb1 = QCheckBox("选项1")
cb2 = QCheckBox("选项2")
cb1.stateChanged.connect(on_check_change)
cb2.stateChanged.connect(on_check_change)
</font></p>基本上就这些。复选框在表单、设置界面中很常用，结合布局和信号机制就能灵活控制交互逻辑。
