Тип QML GroupBox

Визуальная рамка и заголовок для логической группы элементов управления. Подробнее...

• Список всех членов, включая унаследованные члены

Свойства

• implicitLabelHeight : real
• implicitLabelWidth : real
• label : Item
• title : string

Подробное описание

GroupBox используется для размещения логической группы элементов управления вместе, в пределах визуальной рамки с заголовком. GroupBox не предоставляет собственной компоновки, но требует от вас размещения содержимого, например, создав RowLayout или ColumnLayout.

Элементы, объявленные как дочерние элементы GroupBox, автоматически добавляются в качестве дочерних элементов к contentItem GroupBox. Динамически созданные элементы должны быть явно добавлены в качестве дочерних элементов к 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 не имеет встроенного флажка, создание флажка 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 и Контейнерные элементы управления.

Документация по свойствам

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitLabelHeight : real

Это свойство содержит неявную высоту метки.

Значение равно label ? label.implicitHeight : 0.

Это свойство было введено в QtQuick.Controls 2.5 (Qt 5.12).

См. также implicitLabelWidth.

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitLabelWidth : real

Это свойство содержит неявную ширину метки.

Значение равно label ? label.implicitWidth : 0.

Это свойство было введено в QtQuick.Controls 2.5 (Qt 5.12).

См. также implicitLabelHeight.

label : Item

Это свойство содержит элемент метки, который визуализирует title.

См. также Настройка GroupBox.

title : string

Это свойство содержит заголовок.

Заголовок обычно отображается над GroupBox для обобщения его содержимого.