Тип QML GroupBox

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

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

Свойства

• label : Item
• title : строка

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

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

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

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

label : Item

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

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

title : строка

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

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