Sur cette page

Page QML Type

Contrôle de page stylisé prenant en charge un en-tête et un pied de page. En savoir plus…

Import Statement: import QtQuick.Controls
Inherits:

Pane

Propriétés

Description détaillée

Page est un contrôle conteneur qui permet d'ajouter facilement un élément de type « header » et « footer » à une page.

Mise en page présentant l'en-tête, la zone de contenu et le pied de page

Les éléments déclarés comme enfants d'une Page sont :

  • automatiquement rattachés au `contentItem` de la Page. Les éléments créés dynamiquement doivent être explicitement rattachés au `contentItem`.
  • ne sont pas automatiquement positionnés ni redimensionnés.

L'extrait de code suivant illustre comment utiliser un en-tête de barre d'outils spécifique à la page et un pied de page de barre d'onglets à l'échelle de l'application.

import QtQuick.Controls
import QtQuick.Layouts

ApplicationWindow {
    visible: true

    StackView {
        anchors.fill: parent

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

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

    footer: TabBar {
        // ...
    }
}

Voir également « ApplicationWindow» , «Container Controls» et «Focus Management» dans « Qt Quick Controls ».

Documentation sur les propriétés

Cette propriété définit l'élément de pied de page. L'élément de pied de page est positionné tout en bas et redimensionné pour s'adapter à la largeur de la page. La valeur par défaut est null.

Remarque : l'attribution d'une valeur « ToolBar », « TabBar » ou « DialogButtonBox » au pied de page définit automatiquement la propriété correspondante « ToolBar::position », « TabBar::position » ou « DialogButtonBox::position » sur « Footer ».

Voir également header et ApplicationWindow::footer.

header : Item

Cette propriété contient l'élément d'en-tête de la page. L'élément d'en-tête est positionné en haut de la page et redimensionné pour s'adapter à la largeur de celle-ci. La valeur par défaut est null.

Remarque : l'attribution d'une valeur « ToolBar », « TabBar » ou « DialogButtonBox » à l'en-tête de page définit automatiquement la propriété correspondante « ToolBar::position », « TabBar::position » ou « DialogButtonBox::position » sur « Header ».

Voir également footer et ApplicationWindow::header.

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

Cette propriété contient la hauteur implicite du pied de page.

Sa valeur est égale à ` footer && footer.visible ? footer.implicitHeight : 0`.

Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

Voir également implicitFooterWidth et implicitHeaderHeight.

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

Cette propriété contient la largeur implicite du pied de page.

Sa valeur est égale à « footer && footer.visible ? footer.implicitWidth : 0 ».

Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

Voir également implicitFooterHeight et implicitHeaderWidth.

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

Cette propriété contient la hauteur implicite de l'en-tête.

Sa valeur est égale à ` header && header.visible ? header.implicitHeight : 0`.

Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

Voir également implicitHeaderWidth et implicitFooterHeight.

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

Cette propriété contient la largeur implicite de l'en-tête.

Sa valeur est égale à header && header.visible ? header.implicitWidth : 0.

Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

Voir également implicitHeaderHeight et implicitFooterWidth.

title : string

Cette propriété contient le titre de la page.

Le titre s'affiche souvent en haut d'une page afin de fournir à l'utilisateur des informations contextuelles sur la page qu'il consulte.

Page n'affiche pas le titre elle-même, mais s'en remet à l'application pour le faire. Par exemple :

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.