Тип QML GroupBox

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

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

Свойства

• implicitLabelHeight : вещественное число
• implicitLabelWidth : вещественное число
• label : Элемент
• title : строка

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

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 и Контейнерные элементы управления.

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

[только для чтения] implicitLabelHeight : вещественное число

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

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

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

См. также implicitLabelWidth.

[только для чтения] implicitLabelWidth : вещественное число

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

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

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

См. также implicitLabelHeight.

label : Элемент

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

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

title : строка

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

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