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

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

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

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

contentChildren : list<Item>

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

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

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

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

[default] contentData : list<Object>

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

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

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

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

contentHeight : real

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

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

См. также contentWidth.

contentWidth : real

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

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

См. также contentHeight.