Sur cette page

PageIndicator QML Type

Indique la page actuellement active. En savoir plus...

Import Statement: import QtQuick.Controls
Inherits:

Control

Propriétés

Description détaillée

PageIndicator sert à indiquer la page actuellement active dans un conteneur comportant plusieurs pages. PageIndicator se compose d'éléments délégués qui présentent les pages.

Indicateur de page indiquant la page actuelle

Column {
    StackLayout {
        id: stackLayout

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

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

Voir également « SwipeView» , «Personnalisation de 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 actuelle.

delegate : Component

Cette propriété contient un délégué chargé d'afficher 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: boolIndique si l'élément est enfoncé

PageIndicator ne prend pas possession du délégué.

interactive : bool

Cette propriété indique si le contrôle est interactif. Un indicateur de page interactif réagit aux clics et modifie automatiquement l'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 indicateursde page sont généralement assez petits (afin de ne pas détourner l’attention de l’utilisateur du contenu réel de l’interface utilisateur). Ils peuvent être difficiles à cliquer et l’utilisateur peut ne pas les reconnaître facilement comme interactifs. Pour ces raisons, il est préférable de les utiliser en complément des 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.