Тип QML GroupBox

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

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

Свойства

• checkable : bool
• checked : bool
• contentItem : Item
• flat : bool
• title : string

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

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

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

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

Для добавления содержимого в группу с рамкой вы можете переместить его в свойство contentItem.

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

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

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

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

checked : bool

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

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

По умолчанию группы с рамкой, имеющие возможность выбора, также выбраны.

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

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

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

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

flat : bool

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

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

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

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

title : string

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

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