页面 QML 类型

带头部和底部支持的样式页面控件。更多...

导入声明	import QtQuick.Controls
继承	Panel

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

属性

底部 : Item
头部 : Item
隐式底部高度 : real (自 QtQuick.Controls 2.5 (Qt 5.12))
隐式底部宽度 : real (自 QtQuick.Controls 2.5 (Qt 5.12))
隐式头部高度 : real (自 QtQuick.Controls 2.5 (Qt 5.12))
隐式头部宽度 : real (自 QtQuick.Controls 2.5 (Qt 5.12))
标题 : string

详细描述

Page 是一个容器控件，可以将头部和底部项目添加到页面中。

作为页面对象子对象的项

会自动设置为页面内容项的父母。动态创建的项需要显式设置为内容项。
不会自动定位或调整大小。

以下示例片段说明了如何使用特定于页面的工具栏头部和应用程序范围内的选项卡栏底部。

import QtQuick.Controls
import QtQuick.Layouts

ApplicationWindow {
    visible: true

    StackView {
        anchors.fill: parent

        initialItem: Page {
            header: ToolBar {
                // ...
            }

            ColumnLayout {
                anchors.fill: parent
                // ...
            }
        }
    }

    footer: TabBar {
        // ...
    }
}

另请参阅 ApplicationWindow，容器控件和 Qt Quick Controls 中的焦点管理。

属性文档

此属性包含页面底部项。底部项定位在底部，并调整大小以匹配页面的宽度。默认值为 null。

注意: 将 ToolBar、TabBar 或 DialogButtonBox 作为页面底部时，将自动将相应的 ToolBar::position、TabBar::position 或 DialogButtonBox::position 属性设置为 Footer。

另请参阅 头部和 ApplicationWindow::footer。

页眉 : Item

此属性包含页眉的内容。页眉内容定位在顶部，并且调整至页面宽度。默认值是 null。

注意：将工具栏、标签栏或对话框按钮框作为页眉内容会自动将相应的 ToolBar::position、TabBar::position 或 DialogButtonBox::position 属性设为 Header。

另请参阅：页脚和 ApplicationWindow::header。

implicitFooterHeight : real [只读，自 QtQuick.Controls 2.5 （Qt 5.12）起]

此属性包含隐式页脚高度。

该值等于 footer && footer.visible ? footer.implicitHeight : 0。

该属性是在 QtQuick.Controls 2.5 (Qt 5.12) 版本中引入的。

另请参阅：implicitFooterWidth 和 implicitHeaderHeight。

implicitFooterWidth : real [只读，自 QtQuick.Controls 2.5 (Qt 5.12) 起]

此属性包含隐式页脚宽度。

该值等于 footer && footer.visible ? footer.implicitWidth : 0。

该属性是在 QtQuick.Controls 2.5 (Qt 5.12) 版本中引入的。

另请参阅：implicitFooterHeight 和 implicitHeaderWidth。

implicitHeaderHeight : real [只读，自 QtQuick.Controls 2.5 (Qt 5.12) 起]

此属性包含隐式页眉高度。

该值等于 header && header.visible ? header.implicitHeight : 0。

该属性是在 QtQuick.Controls 2.5 (Qt 5.12) 版本中引入的。

另请参阅：implicitHeaderWidth 和 implicitFooterHeight。

implicitHeaderWidth : real [只读，自 QtQuick.Controls 2.5 (Qt 5.12) 起]

此属性包含隐式页眉宽度。

该值等于 header && header.visible ? header.implicitWidth : 0。

该属性是在 QtQuick.Controls 2.5 (Qt 5.12) 版本中引入的。

另请参阅：implicitHeaderHeight 和 implicitFooterWidth。

title : string

此属性包含页面标题。

标题通常显示在页面的顶部，以使用户了解他们正在查看的页面。

页面本身不渲染标题，而是依赖于应用程序来渲染。例如

ApplicationWindow {
    visible: true
    width: 400
    height: 400

    header: Label {
        text: view.currentItem.title
        horizontalAlignment: Text.AlignHCenter
    }

    SwipeView {
        id: view
        anchors.fill: parent

        Page {
            title: qsTr("Home")
        }
        Page {
            title: qsTr("Discover")
        }
        Page {
            title: qsTr("Activity")
        }
    }
}