Тип 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 для обобщения его содержимого.