GroupBox QML 类型

用于布局一组逻辑控件的可视框架和标题。 更多...

• 包括继承成员的所有成员列表

属性

• implicitLabelHeight : real (自 QtQuick.Controls 2.5 (Qt 5.12) 起使用)
• implicitLabelWidth : real (自 QtQuick.Controls 2.5 (Qt 5.12) 起使用)
• label : Item
• title : string

详细描述

GroupBox 用于将一组逻辑控件布局在一个标题可视框架内。GroupBox 不提供自己的布局，但需要您定位其内容，例如通过创建一个 行布局 或一个 列布局。

声明为 GroupBox 子项的项将自动成为 GroupBox 的 内容项 的父项。动态创建的项需要显式地将父项设置为内容项。

如果 GroupBox 中只使用一个项，它将调整大小以适应其包含项的隐式大小。这使得它与布局一起使用尤其适合。

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

可检查的 GroupBox

尽管 GroupBox 没有内置的复选框，但通过将其与一个 复选框 配对，可以很容易地创建一个可检查的 GroupBox。

在复选框开启或关闭时启用或禁用 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") }
    }
}

另请参阅复选框，自定义 GroupBox，以及 容器控件。

属性文档