Back to Qt.io
Contact Us Blog Download Qt

Page QML Type

Gestaltete Seitensteuerung mit Unterstützung für eine Kopf- und Fußzeile. Mehr...

Import Statement: import QtQuick.Controls
Inherits:

Pane

Eigenschaften

Detaillierte Beschreibung

Page ist ein Container-Steuerelement, das das Hinzufügen eines header und footer Elements zu einer Seite erleichtert.

Elemente, die als Kinder einer Seite deklariert sind, werden:

  • automatisch dem contentItem der Seite untergeordnet. Elemente, die dynamisch erstellt werden, müssen explizit dem contentItem zugeordnet werden.
  • werden nicht automatisch positioniert oder in der Größe verändert.

Das folgende Beispiel veranschaulicht die Verwendung einer seitenbezogenen Symbolleiste als Kopfzeile und einer anwendungsweiten Tabulatorleiste als Fußzeile.

import QtQuick.Controls
import QtQuick.Layouts

ApplicationWindow {
    visible: true

    StackView {
        anchors.fill: parent

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

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

    footer: TabBar {
        // ...
    }
}

Siehe auch ApplicationWindow, Container Controls, und Focus Management in Qt Quick Controls.

Eigenschaft Dokumentation

Diese Eigenschaft enthält das Fußzeilenelement der Seite. Das Fußzeilenelement wird am unteren Rand positioniert und in der Größe an die Breite der Seite angepasst. Der Standardwert ist null.

Hinweis: Wenn Sie ToolBar, TabBar oder DialogButtonBox als Seitenfuß zuweisen, wird die entsprechende Eigenschaft ToolBar::position, TabBar::position oder DialogButtonBox::position automatisch auf Footer gesetzt.

Siehe auch header und ApplicationWindow::footer.


header : Item

Diese Eigenschaft enthält das Kopfzeilenelement der Seite. Das Kopfzeilenelement wird oben positioniert und in der Größe an die Breite der Seite angepasst. Der Standardwert ist null.

Hinweis: Wenn Sie ToolBar, TabBar oder DialogButtonBox als Seitenkopf zuweisen, wird die entsprechende Eigenschaft ToolBar::position, TabBar::position oder DialogButtonBox::position automatisch auf Header gesetzt.

Siehe auch footer und ApplicationWindow::header.


implicitFooterHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Diese Eigenschaft enthält die implizite Höhe der Fußzeile.

Der Wert ist gleich footer && footer.visible ? footer.implicitHeight : 0.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch implicitFooterWidth und implicitHeaderHeight.


implicitFooterWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Diese Eigenschaft enthält die implizite Breite der Fußzeile.

Der Wert ist gleich footer && footer.visible ? footer.implicitWidth : 0.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch implicitFooterHeight und implicitHeaderWidth.


implicitHeaderHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Diese Eigenschaft enthält die implizite Kopfzeilenhöhe.

Der Wert ist gleich header && header.visible ? header.implicitHeight : 0.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch implicitHeaderWidth und implicitFooterHeight.


implicitHeaderWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Diese Eigenschaft enthält die implizite Kopfzeilenbreite.

Der Wert ist gleich header && header.visible ? header.implicitWidth : 0.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch implicitHeaderHeight und implicitFooterWidth.


title : string

Diese Eigenschaft enthält den Seitentitel.

Der Titel wird oft oben auf einer Seite angezeigt, um dem Benutzer einen Überblick über die Seite zu geben, die er gerade betrachtet.

Page rendert den Titel nicht selbst, sondern verlässt sich darauf, dass die Anwendung dies tut. Zum Beispiel:

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

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.