Auf dieser Seite

PageIndicator QML Type

Zeigt die derzeit aktive Seite an. Mehr...

Import Statement: import QtQuick.Controls
Inherits:

Control

Eigenschaften

Ausführliche Beschreibung

PageIndicator dient dazu, die aktuell aktive Seite in einem Container mit mehreren Seiten anzuzeigen. PageIndicator besteht aus Delegat-Elementen, die Seiten darstellen.

Seitenanzeige, die die aktuelle Seitenposition anzeigt

Column {
    StackLayout {
        id: stackLayout

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

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

Siehe auch „ SwipeView“ , „Anpassen von PageIndicator“ und „Indikator-Steuerelemente“.

Dokumentation zu den Eigenschaften

count : int

Diese Eigenschaft gibt die Anzahl der Seiten an.

currentIndex : int

Diese Eigenschaft enthält den Index der aktuellen Seite.

delegate : Component

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

Im Kontext jedes Delegaten stehen die folgenden Eigenschaften zur Verfügung:

index: intDer Index des Elements
gedrückt: boolGibt an, ob das Element gedrückt wurde

PageIndicator übernimmt nicht die Verantwortung für den Delegaten.

interactive : bool

Diese Eigenschaft gibt an, ob das Steuerelement interaktiv ist. Ein interaktiver Seitenindikator reagiert auf Klicks und passt die „ current index “ automatisch entsprechend an.

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 lassen sich unter Umständen nur schwer anklicken und werden vom Benutzer möglicherweise nicht ohne Weiteres als interaktiv erkannt. Aus diesen Gründen sollten sie vorzugsweise als Ergänzung zu den primären Navigationsmethoden (wie z. B. „ SwipeView “) verwendet und diese nicht ersetzen.

Der Standardwert ist „ 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.