GroupBox QML Type使用详解

GroupBox QML Type使用详解

GroupBox是Qt Quick Controls中一个非常实用的控件，用于在标题化的可视化框架内布局一组逻辑控件。本文将详细介绍GroupBox的基本用法、属性以及如何创建可选中的GroupBox。

GroupBox QML Type

GroupBox用于在标题化的可视化框架内布局一组逻辑控件。GroupBox本身不提供布局，但需要您对其内容进行定位，例如通过创建RowLayout或ColumnLayout。

声明为GroupBox子项的项目会自动成为GroupBox的contentItem的父项。动态创建的项目需要明确地与contentItem关联。

如果GroupBox中只使用了单个项目，它将调整大小以适应其所包含项目的隐式大小。因此，它特别适合与布局一起使用。

GroupBox {
    title: qsTr("Synchronize")
    ColumnLayout {
        anchors.fill: parent
        CheckBox { text: qsTr("E-mail") }
        CheckBox { text: qsTr("Calendar") }
        CheckBox { text: qsTr("Contacts") }
    }
}

可选中的GroupBox

尽管GroupBox没有内置复选框，但通过将其与CheckBox配对，可以直接创建一个可复选的GroupBox。

当复选框打开或关闭时，启用或禁用组框的子代是一种常见的模式，但复选框的行为由应用程序决定。

GroupBox {
    label: CheckBox {
        id: checkBox
        checked: true
        text: qsTr("Synchronize")
    }
    ColumnLayout {
        anchors.fill: parent
        enabled: checkBox.checked
        CheckBox { text: qsTr("E-mail") }
        CheckBox { text: qsTr("Calendar") }
        CheckBox { text: qsTr("Contacts") }
    }
}

属性文档

implicitLabelHeight

该属性用于保存隐式标签高度。其值等于：

label ? label.implicitHeight : 0

该属性在QtQuick.Controls 2.5 (Qt 5.12)中引入。

implicitLabelWidth

该属性保存隐式标签宽度。其值等于：

label ? label.implicitWidth : 0

该属性在QtQuick.Controls 2.5 (Qt 5.12)中引入。

label

该属性保存可视化标题的标签项。

title

该属性包含标题。标题通常显示在组框上方，以概括其内容。

本文原文来自Qt官方文档