Тип 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 {
    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 : список<Элемент>

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

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

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

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

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

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

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

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

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

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

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

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

См. также contentWidth.

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

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

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

См. также contentHeight.