SwipeView QML Type

Ermöglicht es dem Benutzer, durch seitliches Wischen zwischen den Seiten zu wechseln. Mehr...

• Liste aller Mitglieder, einschließlich vererbter Mitglieder

Eigenschaften

• horizontal : bool (since QtQuick.Controls 2.3 (Qt 5.10))
• interactive : bool (since QtQuick.Controls 2.1 (Qt 5.8))
• orientation : enumeration (since QtQuick.Controls 2.2 (Qt 5.9))
• vertical : bool (since QtQuick.Controls 2.3 (Qt 5.10))

Zugehörige Eigenschaften

• index : int
• isCurrentItem : bool
• isNextItem : bool (since QtQuick.Controls 2.1 (Qt 5.8))
• isPreviousItem : bool (since QtQuick.Controls 2.1 (Qt 5.8))
• view : SwipeView

Ausführliche Beschreibung

SwipeView bietet ein auf Wischgesten basierendes Navigationsmodell.

SwipeView wird mit einer Reihe von Seiten gefüllt. Es ist jeweils nur eine Seite sichtbar. Der Benutzer kann durch seitliches Wischen zwischen den Seiten navigieren. Beachten Sie, dass SwipeView selbst völlig nicht-visuell ist. Es wird empfohlen, es mit PageIndicator zu kombinieren, um dem Benutzer einen visuellen Hinweis darauf zu geben, dass mehrere Seiten vorhanden sind.

SwipeView {
    id: view

    currentIndex: 1
    anchors.fill: parent

    Item {
        id: firstPage
    }
    Item {
        id: secondPage
    }
    Item {
        id: thirdPage
    }
}

PageIndicator {
    id: indicator

    count: view.count
    currentIndex: view.currentIndex

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

Wie oben gezeigt, wird SwipeView in der Regel mit einer statischen Sammlung von Seiten gefüllt, die inline als untergeordnete Elemente der Ansicht definiert sind. Es ist auch möglich, Seiten zur Laufzeit dynamisch über „ add “, „ insert “, „ move “ und „ remove “ hinzuzufügen.

Wenn SwipeView mit einem anderen Container wie beispielsweise TabBar gekoppelt ist, muss eine bidirektionale Bindung zwischen den Eigenschaften currentIndex der jeweiligen Steuerelemente hergestellt werden. Um dies zu erreichen, ohne dass Bindungen unterbrochen werden, sollten Sie es vermeiden, currentIndex direkt zu setzen, und stattdessen beispielsweise setCurrentIndex() verwenden. Weitere Informationen finden Sie unter Managing the Current Index.

Um eine Aktion auszuführen, wenn sich „ currentIndex “ ändert, verwenden Sie den Signal-Handler für die Änderung der Eigenschaft „ onCurrentIndexChanged “:

onCurrentIndexChanged: {
    print("currentIndex changed to", currentIndex)
    // ...
}

Es ist generell nicht ratsam, einer `SwipeView` eine übermäßige Anzahl von Seiten hinzuzufügen. Wenn die Anzahl der Seiten jedoch zunimmt oder einzelne Seiten relativ komplex sind, kann es sinnvoll sein, Ressourcen freizugeben, indem Seiten entladen werden, die sich außerhalb der unmittelbaren Reichweite des Benutzers befinden. Das folgende Beispiel zeigt, wie man „ Loader “ verwendet, um maximal drei Seiten gleichzeitig instanziiert zu halten.

SwipeView {
    Repeater {
        model: 6
        Loader {
            active: SwipeView.isCurrentItem || SwipeView.isNextItem || SwipeView.isPreviousItem
            sourceComponent: Text {
                text: index
                Component.onCompleted: console.log("created:", index)
                Component.onDestruction: console.log("destroyed:", index)
            }
        }
    }
}

Siehe auch TabBar, PageIndicator, „SwipeView anpassen“, „Navigationssteuerelemente“, „Container-Steuerelemente“ und „Fokusverwaltung“ unter Qt Quick Controls.

Dokumentation zu den Eigenschaften

horizontal : bool [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

Diese Eigenschaft gibt an, ob die Swipe-Ansicht horizontal ist.

Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

Siehe auch orientation.

interactive : bool [since QtQuick.Controls 2.1 (Qt 5.8)]

Diese Eigenschaft gibt an, ob der Benutzer mit der „ SwipeView “ interagieren kann. Der Benutzer kann nicht durch eine Ansicht wischen, die nicht interaktiv ist.

Der Standardwert ist „ true “.

Diese Eigenschaft wurde in QtQuick.Controls 2.1 (Qt 5.8) eingeführt.

orientation : enumeration [since QtQuick.Controls 2.2 (Qt 5.9)]

Diese Eigenschaft enthält die Ausrichtung.

Mögliche Werte:

Diese Eigenschaft wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Siehe auch „ horizontal “ und „ vertical “.

vertical : bool [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

Diese Eigenschaft gibt an, ob die Wischansicht vertikal ist.

Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

Siehe auch „ orientation “.

Dokumentation zu angehängten Eigenschaften

SwipeView.index : int [read-only attached]

Diese zugehörige Eigenschaft enthält den Index jedes untergeordneten Elements in der „ SwipeView “.

Sie ist jedem untergeordneten Element der ` SwipeView` zugeordnet.

SwipeView.isCurrentItem : bool [read-only attached]

Diese zugehörige Eigenschaft lautet „ true “, wenn dieses untergeordnete Element das aktuelle Element ist.

Sie ist jedem untergeordneten Element von „ SwipeView “ zugeordnet.

SwipeView.isNextItem : bool [read-only attached, since QtQuick.Controls 2.1 (Qt 5.8)]

Diese zugehörige Eigenschaft lautet „ true “, wenn dieses untergeordnete Element das nächste Element ist.

Sie ist jedem untergeordneten Element von „ SwipeView “ zugeordnet.

Diese Eigenschaft wurde in QtQuick.Controls 2.1 (Qt 5.8) eingeführt.

SwipeView.isPreviousItem : bool [read-only attached, since QtQuick.Controls 2.1 (Qt 5.8)]

Diese zugeordnete Eigenschaft lautet „ true “, wenn dieses untergeordnete Element das vorherige Element ist.

Sie ist jedem untergeordneten Element von ` SwipeView` zugeordnet.

Diese Eigenschaft wurde in QtQuick.Controls 2.1 (Qt 5.8) eingeführt.

SwipeView.view : SwipeView [read-only attached]

Diese angehängte Eigenschaft enthält die Ansicht, die dieses untergeordnete Element verwaltet.

Sie ist jedem untergeordneten Element von „ SwipeView “ zugeordnet.