PageIndicator QML Type

Zeigt die derzeit aktive Seite an. Mehr...

Import Statement: import QtQuick.Controls
Inherits:

Control

Eigenschaften

Ausführliche Beschreibung

PageIndicator wird verwendet, um die derzeit aktive Seite in einem Container mit mehreren Seiten anzuzeigen. PageIndicator besteht aus delegierten Elementen, die Seiten darstellen.

Column {
    StackLayout {
        id: stackLayout

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

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

Siehe auch SwipeView, Anpassen von PageIndicator und Indicator Controls.

Eigenschaft Dokumentation

count : int

Diese Eigenschaft enthält die Anzahl der Seiten.


currentIndex : int

Diese Eigenschaft enthält den Index der aktuellen Seite.


delegate : Component

Diese Eigenschaft enthält einen Delegaten, der eine Seite anzeigt.

Die folgenden Eigenschaften sind im Kontext der einzelnen Delegaten verfügbar:

index: intDer Index des Elements
gedrückt: boolOb das Element gedrückt ist

interactive : bool

Diese Eigenschaft gibt an, ob das Steuerelement interaktiv ist. Ein interaktiver Seitenindikator reagiert auf Drücken und ändert automatisch die current index entsprechend.

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
}

Hinweis: Seitenanzeigen sind in der Regel recht klein (um den Benutzer nicht vom eigentlichen Inhalt der Benutzeroberfläche abzulenken). Sie können schwer anzuklicken sein und werden vom Benutzer möglicherweise nicht ohne weiteres als interaktiv erkannt. Aus diesen Gründen werden sie am besten als Ergänzung zu den primären Navigationsmethoden (z. B. SwipeView) verwendet, nicht als Ersatz für diese.

Der Standardwert ist false.


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