Тип QML Pane
Обеспечивает фон, соответствующий стилю и теме приложения. Подробнее...
| Оператор импорта: | import QtQuick.Controls |
| С момента: | Qt 5.7 |
| Наследует: | |
| Наследуется от: | Frame, Page, ScrollView и ToolBar |
Свойства
- contentChildren : список<Item>
- contentData : список<Объект>
- contentHeight : вещественное
- contentWidth : вещественное
Подробное описание
Pane обеспечивает цвет фона, соответствующий стилю и теме приложения. Pane не предоставляет собственной компоновки, но требует размещения содержимого, например, создавая RowLayout или ColumnLayout.
Элементы, объявленные как дочерние элементы Pane, автоматически добавляются к contentItem Pane. Динамически созданные элементы необходимо явно добавить к contentItem.
Размер содержимого
Если используется только один элемент в Pane, он будет изменён для соответствия неявным размерам содержащего элемента. Это делает его особенно подходящим для использования совместно с макетами.
Pane {
ColumnLayout {
anchors.fill: parent
CheckBox { text: qsTr("E-mail") }
CheckBox { text: qsTr("Calendar") }
CheckBox { text: qsTr("Contacts") }
}
} Иногда в pane может быть два элемента:
Pane {
SwipeView {
// ...
}
PageIndicator {
anchors.horizontalCenter: parent.horizontalCenter
anchors.bottom: parent.bottom
}
} В этом случае Pane не может рассчитать разумный неявный размер. Поскольку мы привязываем PageIndicator к SwipeView, мы можем просто установить размер содержимого на неявный размер представления:
Pane {
contentWidth: view.implicitWidth
contentHeight: view.implicitHeight
SwipeView {
id: view
// ...
}
PageIndicator {
anchors.horizontalCenter: parent.horizontalCenter
anchors.bottom: parent.bottom
}
} Если у contentItem нет неявного размера и только один дочерний элемент, Pane будет использовать неявный размер этого дочернего элемента. Например, в следующем коде Pane принимает размер Rectangle:
Pane {
Item {
Rectangle {
implicitWidth: 200
implicitHeight: 200
color: "salmon"
}
}
} См. также Настройка Pane, Контейнерные элементы управления, Управление фокусом в Qt Quick Controls и Обработка событий.
Документация свойств
contentChildren : список<Item>
Это свойство содержит список дочерних элементов содержимого.
Список содержит все элементы, объявленные в QML как дочерние элементы pane.
Примечание: В отличие от contentData, contentChildren не включает невизуальные QML-объекты.
См. также Item::children и contentData.
[default] contentData : список<Объект>
Это свойство содержит список данных содержимого.
Список содержит все объекты, объявленные в QML как дочерние элементы pane.
Примечание: В отличие от contentChildren, contentData включает невизуальные QML-объекты.
См. также Item::data и contentChildren.
contentHeight : вещественное
Это свойство содержит высоту содержимого. Оно используется для расчёта общей неявной высоты pane.
Для получения дополнительной информации, см. Размер содержимого.
См. также contentWidth.
contentWidth : вещественное
Это свойство содержит ширину содержимого. Оно используется для расчёта общей неявной ширины pane.
Для получения дополнительной информации, см. Размер содержимого.
См. также contentHeight.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qml-qtquick-controls2-pane.html