Auf dieser Seite

Page QML Type

Gestaltetes Seitensteuerelement mit Unterstützung für Kopf- und Fußzeile. Mehr...

Import Statement: import QtQuick.Controls
Inherits:

Pane

Eigenschaften

Ausführliche Beschreibung

„Page“ ist ein Container-Steuerelement, mit dem sich Elemente vom Typ „ header “ und „ footer “ bequem zu einer Seite hinzufügen lassen.

Seitenlayout mit Kopfzeile, Inhaltsbereich und Fußzeile

Elemente, die als untergeordnete Elemente einer „Page“ deklariert werden, werden

  • automatisch dem „contentItem“ der „Page“ zugeordnet. Dynamisch erstellte Elemente müssen explizit dem „contentItem“ zugeordnet werden.
  • Sie werden nicht automatisch positioniert oder in ihrer Größe angepasst.

Der folgende Beispielausschnitt veranschaulicht die Verwendung einer seitenbezogenen Symbolleisten-Kopfzeile und einer anwendungsweiten Tabbar-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 “.

Dokumentation zu den Eigenschaften

Diese Eigenschaft enthält das Fußzeilenelement der Seite. Das Fußzeilenelement wird am unteren Rand positioniert und auf die Breite der Seite angepasst. Der Standardwert lautet „ null “.

Hinweis: Wenn Sie „ ToolBar “, „ TabBar “ oder „ DialogButtonBox “ als Seitenfußzuweisen , wird die jeweilige 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 Seitenkopfelement. Das Kopfelement wird oben positioniert und auf die Breite der Seite angepasst. Der Standardwert lautet null.

Hinweis: Wenn Sie „ ToolBar “, „ TabBar “ oder „ DialogButtonBox “ als Seitenkopfzuweisen , wird die jeweilige 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 Fußzeilenhöhe.

Der Wert entspricht „ 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 entspricht „ 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 entspricht „ 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 Header-Breite.

Der Wert entspricht „ 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 häufig oben auf einer Seite angezeigt, um dem Benutzer Informationen zum Kontext der gerade angezeigten Seite zu geben.

„Page“ rendert den Titel nicht selbst, sondern überlässt dies der Anwendung. 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")
        }
    }
}

© 2026 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.