Sur cette page

Page QML Type

Contrôle de page stylisé avec prise en charge d'un en-tête et d'un pied de page. Plus d'informations...

Import Statement: import QtQuick.Controls
Inherits:

Pane

Propriétés

Description détaillée

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

Mise en page montrant 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 à l'élément contentItem de la page. Les éléments créés dynamiquement doivent être explicitement rattachés à l'élément contentItem.
  • ne sont pas automatiquement positionnés ou redimensionnés.

L'exemple suivant montre comment utiliser un en-tête de barre d'outils spécifique à la page et un pied de page de barre d'onglets pour l'ensemble 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, Contrôles de conteneurs, et Gestion du focus dans les contrôles Qt Quick .

Documentation sur les propriétés

Cette propriété contient l'élément de pied de page. L'élément de pied de page est positionné en bas et redimensionné en fonction de la largeur de la page. La valeur par défaut est null.

Remarque : l'attribution d'un élément ToolBar, TabBar ou DialogButtonBox en tant que pied de page définit automatiquement la propriété ToolBar::position, TabBar::position ou DialogButtonBox::position correspondante à 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 et redimensionné en fonction de la largeur de la page. La valeur par défaut est null.

Remarque : l'attribution d'un élément ToolBar, TabBar ou DialogButtonBox en tant qu'en-tête de page définit automatiquement la propriété ToolBar::position, TabBar::position ou DialogButtonBox::position correspondante à Header.

Voir également footer et ApplicationWindow::header.

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

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

La 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é indique la largeur implicite du pied de page.

La 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é indique la hauteur implicite de l'en-tête.

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

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

Voir aussi implicitHeaderWidth et implicitFooterHeight.

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

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

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

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

Voir aussi implicitHeaderHeight et implicitFooterWidth.

title : string

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

Le titre est souvent affiché en haut d'une page pour donner à l'utilisateur le contexte de la page qu'il consulte.

La page ne rend 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.