QML学习笔记（三十三）QML的CheckBox

最新推荐文章于 2025-12-12 09:00:00 发布

原创

最新推荐文章于 2025-12-12 09:00:00 发布 · 1k 阅读

标签

#学习 #笔记 #qt #ui

前言

CheckBox是一个提供可勾选的选项按钮，常用于各种设置界面，它既可以两态（checked/unchecked），也可以三态（checked/partial/unchecked）” 的开关控件。它还可以搭配了ButtonGroup 进行使用，代表同组按钮之间的多选、单选或互斥操作。

一、了解CheckBox

在这里插入图片描述
翻译一下：
CheckBox presents an option button that can be toggled on (checked) or off (unchecked). Check boxes are typically used to select one or more options from a set of options. For larger sets of options, such as those in a list, consider using CheckDelegate instead.
CheckBox inherits its API from AbstractButton. For instance, the state of the checkbox can be set with the checked property.
In addition to the checked and unchecked states, there is a third state: partially checked. The partially checked state can be enabled using the tristate property. This state indicates that the regular checked/unchecked state can not be determined; generally because of other states that affect the checkbox. This state is useful when several child nodes are selected in a treeview, for example.

二、简单实现

我们新建三个CheckBox看看效果：

        ColumnLayout {
   
   
            CheckBox {
   
   
                checked: true
                text: qsTr("First")
            }
            CheckBox {
   
   
                text: qsTr("Second")
            }
            CheckBox {
   
   
                checked: true
                text: qsTr("Third")
            }
        }