qcheckbox 开关

使用 QCheckBox 实现开关功能
基本概念
QCheckBox 是 Qt 中用于提供复选框控件的类。该控件可以被用来表示两种状态之一：选中或未选中。当 QCheckBox 被配置成三态模式时，则还可以拥有部分选中的中间状态[^2]。
创建基本的 QCheckBox 开关
为了创建一个简单的二元开关，即只有开/关两个状态的组件，可以直接实例化 QCheckBox 并设置其文本标签为空字符串（如果不需要显示文字）。下面展示的是如何构建这样一个最基础版本：
#include <QtWidgets>

int main(int argc, char *argv[])
{
QApplication app(argc, argv);

QWidget window;
QVBoxLayout layout(&amp;window);

// 初始化无文本的 CheckBox 作为开关
QCheckBox checkBox("");
layout.addWidget(&amp;checkBox);

window.setLayout(&amp;layout);
window.show();

return app.exec();
}
登录后复制
此代码片段展示了怎样初始化并布置一个不带任何描述性的纯图形化的切换按钮。
绑定行为到 QCheckBox 状态变化事件上
为了让 QCheckBox 更加实用，在实际应用中通常会希望每当用户改变它的状态时触发某些特定操作。这可以通过连接信号与槽机制完成。例如，使能其他输入字段取决于这个复选框的状态:
// ... 上面的例子继续...

QLineEdit lineEdit;
lineEdit.setEnabled(false); // 默认禁用编辑框

layout.addWidget(&amp;lineEdit);

QObject::connect(&amp;checkBox, &amp;QCheckBox::stateChanged,
[&amp;]() {
lineEdit.setEnabled(checkBox.isChecked());
});

// ...
登录后复制
这里定义了一个匿名函数作为槽函数，它会在每次 QCheckBox 的状态发生变化时被执行，并相应地更新关联部件(QLineEdit)的可用性属性。
应用样式表美化外观
对于追求更美观界面的应用程序来说，仅依靠默认风格可能不够吸引人。这时就可以利用 Qt 提供的强大 CSS 类似语法——样式表(QSS)，来自由调整各个 UI 控件的表现形式。针对 QCheckBox 来说，能够修改指示器大小、背景颜色以及边框等特性以模拟真实的硬件开关效果[^1]:
/* 定义全局范围内的所有 QCheckBox */
QCheckBox::indicator {
width : 30px;
height: 18px;
}

/* 当处于未勾选状态下 */
QCheckBox::indicator:unchecked {
image:url(:/path/to/unchecked_image.png);
}

/* 已经勾选的情况下 */
QCheckBox::indicator:checked {
image:url(:/path/to/checked_image.png);
}
登录后复制
上述样式的具体路径应替换为项目中存在的适当资源文件位置。此外也可以直接指定颜色代替图片来简化开发过程。