Тип QML GroupBox

GroupBox предоставляет рамку группы с заголовком. Подробнее...

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

Свойства

• checkable : bool
• checked : bool
• contentItem : Item
• flat : bool
• title : строка

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

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

Элементы управления дочерними элементами в группах с флажками включены или отключены в зависимости от того, отмечена ли группа.

Вы можете уменьшить потребление места группой, включив свойство flat. В большинстве стилей включение этого свойства приводит к удалению левого, правого и нижнего краев рамки.

Чтобы добавить содержимое в группу, вы можете переместить его в свойство contentItem.

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

Следующий пример демонстрирует, как мы используем GroupBox:

GroupBox {
    title: "Joining for?"

    Column {
        spacing: 10

        CheckBox {
            text: "Breakfast"
            checked: true
        }
        CheckBox {
            text: "Lunch"
            checked: false
        }
        CheckBox {
            text: "Dinner"
            checked: true
        }
    }
}

См. также CheckBox, RadioButton и Layout.

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

checkable : bool

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

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

По умолчанию группы не являются флажками.

checked : bool

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

Если группа является флажком, она отображается с флажком. Если флажок отмечен, дочерние элементы группы включены; в противном случае дочерние элементы отключены и недоступны пользователю.

По умолчанию группы, являющиеся флажками, также отмечены.

[только для чтения] contentItem : Item

Это свойство содержит элемент содержимого группы.

Элементы, объявленные как дочерние элементы GroupBox, автоматически добавляются в качестве дочерних элементов GroupBox's contentItem. Динамически созданные элементы необходимо явно добавить в contentItem:

Примечание: Неявный размер GroupBox вычисляется на основе размера его содержимого. Если вы хотите прикрепить элементы внутри группы, вы должны указать явную ширину и высоту на самом GroupBox.

flat : bool

Это свойство указывает, является ли группа плоской или имеет рамку.

Группа обычно состоит из окружающей рамки с заголовком вверху. Если это свойство включено, в большинстве стилей рисуется только верхняя часть рамки; в противном случае рисуется вся рамка.

По умолчанию это свойство отключено, поэтому группы не являются плоскими, если не указано явно.

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

title : строка

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

Текст заголовка по умолчанию отсутствует.