QML Pane类

导入	import QtQuick.Controls 2.1
继承	Control
被继承	Frame, Page, ScrollView, and ToolBar

Properties

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

细节描述
窗格提供与应用程序样式和主题相匹配的背景颜色。窗格本身不提供布局，但要求您定位其内容，例如通过创建RowLayout或ColumnLayout。

声明为窗格子元素的项自动成为窗格内容项的父元素。动态创建的项需要显式地成为contentItem的父项。

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

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不能计算合理的隐式大小。因为我们在SwipeView上锚定PageIndicator，我们可以简单地设置内容大小为视图的隐式大小:

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

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

如果内容项没有隐式大小且只有一个子项，则Pane将使用该子项的隐式大小。例如，在下面的代码中，Pane假定矩形的大小:

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

属性
contentChildren : list< Item>
此属性保存内容子列表。

该列表包含在QML中声明为窗格子元素的所有项。

注意:与contentData不同，contentChildren不包括非可视的QML对象。

contentData : list< Object>
此属性保存内容数据的列表。

该列表包含在QML中声明为窗格子对象的所有对象。

注意:与contentChildren不同，contentData包含非可视化的QML对象。

contentHeight : real
contentWidth : real
这个属性保存内容的高度。它用于计算窗格的总隐式高度。