GroupBox QML Type

逻辑控件组的可视化框架和标题。更多

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

属性

• implicitLabelHeight : real (since QtQuick.Controls 2.5 (Qt 5.12))
• implicitLabelWidth : real (since QtQuick.Controls 2.5 (Qt 5.12))
• label : Item
• title : string

详细说明

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

声明为 GroupBox 子项的项目会自动成为 GroupBoxcontentItem 的父项。动态创建的项目需要明确地与 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") }
    }
}

另请参阅 CheckBox 、自定义 GroupBox 和容器控件。

属性文档

implicitLabelHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

该属性用于保存隐式标签高度。

其值等于label ? label.implicitHeight : 0 。

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

另请参阅 implicitLabelWidth 。

implicitLabelWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

该属性用于保存隐式标签宽度。

其值等于label ? label.implicitWidth : 0 。

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

另请参阅 implicitLabelHeight 。

label : Item

该属性包含可视化title 的标签项。

另请参阅 自定义 GroupBox。

title : string

该属性包含标题。

标题通常显示在分组框上方，用于概括其内容。