Тип QML Pane

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

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

Свойства

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

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

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

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

contentChildren : список<Элемент>

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

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

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

См. также Элемент::children и contentData.

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

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

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

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

См. также Элемент::data и contentChildren.

contentHeight : вещественное

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

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

См. также contentWidth.

contentWidth : вещественное

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

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

См. также contentHeight.