Тип QML GroupBox

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

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

Свойства

• label : Элемент
• 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 : Элемент

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

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

title : строка

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

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