Sur cette page

PageIndicator QML Type

Indique la page actuellement active. Plus...

Import Statement: import QtQuick.Controls
Inherits:

Control

Propriétés

Description détaillée

PageIndicator est utilisé pour indiquer la page active dans un conteneur de plusieurs pages. PageIndicator se compose d'éléments délégués qui présentent les pages.

Indicateur de page indiquant la position actuelle de la page

Column {
    StackLayout {
        id: stackLayout

        Page {
            // ...
        }
        Page {
            // ...
        }
        Page {
            // ...
        }
    }

    PageIndicator {
        currentIndex: stackLayout.currentIndex
        count: stackLayout.count
    }
}

Voir également SwipeView, Personnaliser PageIndicator et Contrôles d'indicateur.

Documentation sur les propriétés

count : int

Cette propriété contient le nombre de pages.

currentIndex : int

Cette propriété contient l'index de la page en cours.

delegate : Component

Cette propriété contient un délégué qui présente une page.

Les propriétés suivantes sont disponibles dans le contexte de chaque délégué :

index: intL'index de l'élément
pressed: boolSi l'élément est pressé

PageIndicator ne prend pas en charge le délégué.

interactive : bool

Cette propriété indique si le contrôle est interactif. Un indicateur de page interactif réagit aux pressions et modifie automatiquement le site current index en conséquence.

SwipeView {
    id: view
    currentIndex: pageIndicator.currentIndex
    anchors.fill: parent

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

PageIndicator {
    id: pageIndicator
    interactive: true
    count: view.count
    currentIndex: view.currentIndex

    anchors.bottom: parent.bottom
    anchors.horizontalCenter: parent.horizontalCenter
}

Remarque : les indicateurs de page sont généralement assez petits (afin d'éviter de distraire l'utilisateur du contenu réel de l'interface utilisateur). Ils peuvent être difficiles à cliquer et ne pas être facilement reconnus comme interactifs par l'utilisateur. Pour ces raisons, il est préférable de les utiliser pour compléter les méthodes de navigation principales (telles que SwipeView), et non pour les remplacer.

La valeur par défaut est false.

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