Тип QML GroupBox

Элемент управления групповой рамкой. Подробнее...

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

Свойства

• label : Элемент
• title : строка

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

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

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

GroupBox {
    title: qsTr("Synchronize")
    ColumnLayout {
        anchors.fill: parent
        CheckBox { text: qsTr("E-mail") }
        CheckBox { text: qsTr("Calendar") }
        CheckBox { text: qsTr("Contacts") }
    }
}

Групповая рамка с возможностью выбора

Несмотря на то, что GroupBox не имеет встроенной галочки, создание групповой рамки с возможностью выбора не представляет сложности при использовании CheckBox.

Распространённым способом является включение или выключение потомков рамки при включении/выключении соответствующей галочки, но семантика галочки определяется приложением.

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") }
    }
}

Примечание: Типы в модуле Qt.labs не гарантируют сохранение совместимости в будущих версиях.

См. также CheckBox, Настройка GroupBox и Контейнерные элементы управления.

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

label : Item

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

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

title : строка

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