窗格 QML 类型

提供与应用程序风格和主题相匹配的背景。更多...

导入语句	import QtQuick.Controls
继承	控件
由以下继承	Frame、Page、ScrollView 和 ToolBar

包括继承成员的所有成员列表

属性

contentChildren : list<Item>
contentData : list<QtObject>
contentHeight : real
contentWidth : real

详细描述

窗格提供与应用程序风格和主题相匹配的背景颜色。窗格不提供自己的布局，需要您定位其内容，例如通过创建一个 RowLayout 或 ColumnLayout。

作为窗格子项声明的项目将自动成为窗格的 contentItem 的父项。动态创建的项目需要显式地将其设置为父项。

如事件处理中所述，窗格不允许点击和触摸事件穿透到其下方的项目。如果 wheelEnabled 设置为 true，则相同规则也适用于鼠标滚轮事件。

内容大小

如果窗格中只使用单个项目，它将调整大小以适应其包含项目的隐式大小。这使得它与布局一起使用特别合适。

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
    }
}

在这种情况下，窗格无法计算一个合理的隐式大小。由于我们正在将 PageIndicator 锚定在 SwipeView 之上，我们可以简单地将内容大小设置为视图的隐式大小

Pane {
    contentWidth: view.implicitWidth
    contentHeight: view.implicitHeight

    SwipeView {
        id: view
        // ...
    }
    PageIndicator {
        anchors.horizontalCenter: parent.horizontalCenter
        anchors.bottom: parent.bottom
    }
 }

如果 contentItem 没有隐式大小并且只有一个子项，窗格将使用该子项的隐式大小。例如，在以下代码中，窗格假定矩形的尺寸

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

参见自定义窗格、容器控件、Qt 快速控件中的焦点管理和事件处理。

属性文档

contentChildren : list<Item>

此属性包含内容子项的列表。

该列表包含已在QML中声明为该面板子项的所有项目。

注意：与contentData不同，contentChildren不包括非视觉QML对象。

另请参阅：Item::children和contentData。

contentData : list<QtObject> [默认]

此属性包含内容数据列表。

该列表包含已在QML中声明为该面板子项的所有对象。

注意：与contentChildren不同，contentData包括非视觉QML对象。

另请参阅：Item::data和contentChildren。

contentHeight : real

此属性包含内容高度。它用于计算面板的总体隐式高度。

更多信息，请参阅内容尺寸。

另请参阅：contentWidth。

contentWidth : real

此属性包含内容宽度。它用于计算面板的总隐式宽度。

更多信息，请参阅内容尺寸。

另请参阅：contentHeight。