Тип QML Pane

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

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

Свойства

• contentChildren : list<Item>
• contentData : list<Object>
• contentHeight : real
• contentWidth : real

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

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 будет принимать размер Rectangle:

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

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

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

contentChildren : список<Item>

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

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

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

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

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

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

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

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

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

contentHeight : вещественный

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

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

См. также contentWidth.

contentWidth : вещественный

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

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

См. также contentHeight.