Тип QML Pane

Обеспечивает фон, соответствующий стилю и теме приложения. Подробнее...

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

Свойства

• 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 {
    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 принимает размер прямоугольника:

Pane {
    Item {
        Rectangle {
            implicitWidth: 200
            implicitHeight: 200
            color: "salmon"
        }
    }
}

См. также Настройка Pane, Контейнерные элементы управления, Управление фокусом в Qt Quick Controls и Обработка событий.

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

contentChildren : список<Item>

Это свойство содержит список дочерних элементов содержимого.

Список содержит все элементы, объявленные в QML как дочерние для панели.

Примечание: В отличие от contentData, contentChildren не включает невизуальные объекты QML.

См. также Item::children и contentData.

[по умолчанию] contentData : список<Объект>

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

Список содержит все объекты, объявленные в QML как дочерние для панели.

Примечание: В отличие от contentChildren, contentData включает невизуальные объекты QML.

См. также Item::data и contentChildren.

contentHeight : вещественное число

Это свойство содержит высоту содержимого. Используется для расчета общей неявной высоты панели.

Дополнительная информация в размере содержимого.

См. также contentWidth.

contentWidth : вещественное число

Это свойство содержит ширину содержимого. Используется для расчета общей неявной ширины панели.

Дополнительная информация в размере содержимого.

См. также contentHeight.