PyQt5复选框(QCheckBox)使用教程

一、创建基本复选框

创建一个简单的复选框只需几行代码：

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

app = QApplication([])
window = QWidget()
layout = QVBoxLayout()

# 创建复选框
checkbox1 = QCheckBox("启用选项")
checkbox2 = QCheckBox("自动保存")
checkbox3 = QCheckBox("高亮显示")

# 设置默认选中状态
checkbox2.setChecked(True)

# 添加到布局
layout.addWidget(checkbox1)
layout.addWidget(checkbox2)
layout.addWidget(checkbox3)

window.setLayout(layout)
window.show()
app.exec_()

二、复选框的常用方法

• isChecked() - 检查复选框是否被选中
• setChecked(bool) - 设置复选框的选中状态
• setText(str) - 设置复选框显示的文本
• text() - 获取复选框的文本
• toggle() - 切换复选框的选中状态
• stateChanged - 当复选框状态改变时发出的信号

三、处理复选框状态变化

当用户与复选框交互时，我们需要捕捉状态变化事件：

def handle_state_change(state):
    # Qt.Checked 值为2，Qt.Unchecked 值为0
    if state == 2:
        print("复选框被选中")
    else:
        print("复选框未选中")

# 连接信号与槽
checkbox1.stateChanged.connect(handle_state_change)

四、三态复选框的使用

PyQt5支持三态复选框（选中、未选中、部分选中）：

# 创建三态复选框
tri_state_checkbox = QCheckBox("三态选项")

# 启用三态
tri_state_checkbox.setTristate(True)

# 设置部分选中状态
tri_state_checkbox.setCheckState(1)  # 0=未选中, 1=部分选中, 2=选中

# 处理状态变化
def handle_tri_state(state):
    if state == 0:
        print("未选中")
    elif state == 1:
        print("部分选中")
    elif state == 2:
        print("完全选中")

tri_state_checkbox.stateChanged.connect(handle_tri_state)

五、完整示例：选项设置界面

下面是一个包含多个复选框的完整设置界面示例：

import sys
from PyQt5.QtWidgets import (
    QApplication, QWidget, QCheckBox, QPushButton, 
    QVBoxLayout, QGroupBox, QLabel
)

class SettingsWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()
        
    def initUI(self):
        # 创建布局
        main_layout = QVBoxLayout()
        
        # 显示设置组
        display_group = QGroupBox("显示设置")
        display_layout = QVBoxLayout()
        
        self.cb_theme = QCheckBox("深色模式")
        self.cb_fullscreen = QCheckBox("全屏启动")
        self.cb_animations = QCheckBox("启用动画效果")
        
        display_layout.addWidget(self.cb_theme)
        display_layout.addWidget(self.cb_fullscreen)
        display_layout.addWidget(self.cb_animations)
        display_group.setLayout(display_layout)
        
        # 功能设置组
        features_group = QGroupBox("功能设置")
        features_layout = QVBoxLayout()
        
        self.cb_autosave = QCheckBox("自动保存")
        self.cb_backup = QCheckBox("创建备份")
        self.cb_notifications = QCheckBox("显示通知")
        
        features_layout.addWidget(self.cb_autosave)
        features_layout.addWidget(self.cb_backup)
        features_layout.addWidget(self.cb_notifications)
        features_group.setLayout(features_layout)
        
        # 状态标签
        self.status_label = QLabel("当前设置: 未保存")
        
        # 保存按钮
        save_btn = QPushButton("保存设置")
        save_btn.clicked.connect(self.save_settings)
        
        # 添加到主布局
        main_layout.addWidget(display_group)
        main_layout.addWidget(features_group)
        main_layout.addWidget(self.status_label)
        main_layout.addWidget(save_btn)
        
        self.setLayout(main_layout)
        self.setWindowTitle("应用程序设置")
        self.setGeometry(300, 300, 350, 300)
        
    def save_settings(self):
        # 获取所有复选框的状态
        settings = {
            "dark_theme": self.cb_theme.isChecked(),
            "fullscreen": self.cb_fullscreen.isChecked(),
            "animations": self.cb_animations.isChecked(),
            "autosave": self.cb_autosave.isChecked(),
            "backup": self.cb_backup.isChecked(),
            "notifications": self.cb_notifications.isChecked()
        }
        
        # 在实际应用中，这里会将设置保存到配置文件或数据库
        self.status_label.setText("设置已保存!")
        
        # 打印设置结果（仅用于演示）
        print("保存的设置:")
        for key, value in settings.items():
            print(f"{key}: {'启用' if value else '禁用'}")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = SettingsWindow()
    window.show()
    sys.exit(app.exec_())

六、样式化复选框

使用QSS(Qt Style Sheets)可以自定义复选框外观：

# 设置样式
app.setStyleSheet("""
    QCheckBox {
        spacing: 8px;
        font-size: 14px;
        color: #2c3e50;
    }
    
    QCheckBox::indicator {
        width: 18px;
        height: 18px;
        border-radius: 4px;
        border: 2px solid #3498db;
    }
    
    QCheckBox::indicator:checked {
        background-color: #3498db;
        image: url(:/images/checkmark.png);
    }
    
    QCheckBox::indicator:unchecked:hover {
        border: 2px solid #2980b9;
    }
    
    QCheckBox::indicator:checked:hover {
        background-color: #2980b9;
    }
""")

七、常见问题解答