PathView QML Type

Diese Eigenschaften legen den bevorzugten Bereich der Markierung (aktuelles Element) innerhalb der Ansicht fest. Die bevorzugten Werte müssen im Bereich von 0 bis 1 liegen.

Gültige Werte für highlightRangeMode sind:

Der Standardwert ist PathView.StrictlyEnforceRange.

Das Definieren eines Hervorhebungsbereichs ist der richtige Weg, um zu beeinflussen, wo das aktuelle Element landet, wenn sich die Ansicht bewegt. Wenn Sie beispielsweise möchten, dass sich das aktuell ausgewählte Element in der Mitte des Pfads befindet, setzen Sie den Markierungsbereich auf 0.5,0.5 und highlightRangeMode auf PathView.StrictlyEnforceRange. Wenn der Pfad gescrollt wird, ist das aktuell ausgewählte Element das Element an dieser Position. Dies gilt auch, wenn sich das aktuell ausgewählte Element ändert - es wird innerhalb des bevorzugten Markierungsbereichs verschoben. Außerdem verhält sich der aktuelle Elementindex unabhängig davon, ob eine Markierung vorhanden ist oder nicht.

Diese Eigenschaft gibt die maximale Anzahl der Elemente an, die außerhalb des Pfades zwischengespeichert werden sollen.

Ein PathView mit einem Modell, das 20 Elemente enthält, einer pathItemCount von 10 und einer cacheItemCount von 4 wird beispielsweise bis zu 14 Elemente erstellen, wobei 10 Elemente auf dem Pfad sichtbar und 4 Elemente unsichtbar im Cache gespeichert sind.

Die zwischengespeicherten Delegaten werden asynchron erstellt, so dass die Erstellung über mehrere Frames hinweg erfolgen kann und die Wahrscheinlichkeit des Überspringens von Frames verringert wird.

Siehe auch pathItemCount.

Diese Eigenschaft enthält die Anzahl der Elemente im Modell.

Diese Eigenschaft enthält den Index des aktuellen Elements.

Diese Eigenschaft enthält das aktuelle Element in der Ansicht.

Der Delegat bietet eine Vorlage, die jedes Element definiert, das von der Ansicht instanziiert wird. Der Index ist als zugängliche index Eigenschaft verfügbar. Eigenschaften des Modells sind je nach Art des Datenmodells ebenfalls verfügbar.

Die Anzahl der Objekte und Bindungen im Delegaten hat eine direkte Auswirkung auf die Flicking-Leistung der Ansicht, wenn pathItemCount angegeben ist. Wenn möglich, platzieren Sie Funktionalität, die für die normale Anzeige des Delegaten nicht benötigt wird, in einem Loader, der bei Bedarf zusätzliche Komponenten laden kann.

Beachten Sie, dass die PathView die Elemente auf der Grundlage der Größe des Stammelements im Delegaten anordnet.

Hier ist ein Beispiel-Delegat:

    Component {
        id: delegate
        Column {
            id: wrapper

            required property url icon
            required property string name

            opacity: PathView.isCurrentItem ? 1 : 0.5

            Image {
                anchors.horizontalCenter: nameText.horizontalCenter
                width: 64; height: 64
                source: wrapper.icon
            }
            Text {
                id: nameText
                text: wrapper.name
                font.pointSize: 16
            }
        }
    }

Diese Eigenschaft enthält den maximalen Abstand vom Pfad, der das Ziehen mit der Maus auslöst.

Standardmäßig kann der Pfad nur durch Klicken auf ein Element gezogen werden. Wenn dragMargin größer als Null ist, kann ein Ziehen durch Klicken innerhalb von dragMargin Pixeln des Pfades initiiert werden.

Diese Eigenschaft gibt an, ob sich die Ansicht aufgrund des Ziehens durch den Benutzer gerade bewegt.

Diese Eigenschaft gibt die Geschwindigkeit an, mit der ein Flick verlangsamt wird.

Der Standardwert ist 100.

Diese Eigenschaft gibt an, ob sich die Ansicht gerade bewegt, wenn der Benutzer die Ansicht anklickt.

Diese Eigenschaft enthält die Komponente, die als Hervorhebung verwendet wird.

Eine Instanz der Highlight-Komponente wird für jede Ansicht erstellt. Die Geometrie der resultierenden Komponenteninstanz wird von der Ansicht so verwaltet, dass sie beim aktuellen Element bleibt.

Das folgende Beispiel zeigt, wie man eine einfache Hervorhebung erstellt. Beachten Sie die Verwendung der Eigenschaft PathView.onPath attached, um sicherzustellen, dass das Highlight ausgeblendet wird, wenn es vom Pfad weggeschoben wird.

Component {
    Rectangle {
        visible: PathView.onPath
        // ...
    }
}

Siehe auch highlightItem und highlightRangeMode.

highlightItem enthält das Hervorhebungselement, das aus der Komponente highlight erstellt wurde.

Siehe auch highlight.

Diese Eigenschaft enthält die Dauer der Bewegungsanimation des Hervorhebungsdelegaten.

Wenn highlightRangeMode StrictlyEnforceRange ist, bestimmt diese Eigenschaft die Geschwindigkeit, mit der sich die Elemente entlang des Pfades bewegen.

Der Standardwert für die Dauer ist 300 ms.

Ein Benutzer kann eine PathView, die nicht interaktiv ist, nicht ziehen oder streichen.

Diese Eigenschaft ist nützlich, um das Streichen vorübergehend zu deaktivieren. Dies ermöglicht eine besondere Interaktion mit den Kindern von PathView.

Diese Eigenschaft enthält die ungefähre maximale Geschwindigkeit, mit der der Benutzer die Ansicht in Pixel/Sekunde bewegen kann.

Der Standardwert ist plattformabhängig.

Diese Eigenschaft enthält das Modell, das Daten für die Ansicht bereitstellt.

Das Modell stellt eine Reihe von Daten bereit, die zur Erstellung der Elemente für die Ansicht verwendet werden. Bei großen oder dynamischen Datensätzen wird das Modell normalerweise durch ein C++-Modellobjekt bereitgestellt. Modelle können auch direkt in QML erstellt werden, indem der Typ ListModel verwendet wird.

Siehe auch Datenmodelle.

Diese Eigenschaft bestimmt die Richtung, in die sich Elemente beim Setzen des aktuellen Indexes bewegen. Die möglichen Werte sind:

Nehmen wir zum Beispiel an, dass es 5 Gegenstände im Modell gibt und currentIndex auf 0 eingestellt ist. Wenn currentIndex auf 2 eingestellt ist,

• wird eine Positive Bewegungsrichtung in der folgenden Reihenfolge ergeben: 0, 1, 2
• eine Negative Bewegungsrichtung führt zu der folgenden Reihenfolge: 0, 5, 4, 3, 2
• eine Shortest Bewegungsrichtung ergibt die gleiche Reihenfolge wie bei Positive.

Diese Eigenschaft gibt an, ob sich die Ansicht gerade bewegt, weil der Benutzer die Ansicht zieht oder anklickt.

Der Offset gibt an, wie weit sich die Elemente von ihrer Ausgangsposition entfernt befinden. Dies ist eine reelle Zahl, die von 0 bis zur Anzahl der Elemente im Modell reicht.

Diese Eigenschaft enthält den Pfad, der für die Anordnung der Elemente verwendet wird. Weitere Informationen finden Sie in der Dokumentation Path.

Diese Eigenschaft enthält die Anzahl der Elemente, die zu einem bestimmten Zeitpunkt auf dem Pfad sichtbar sind.

Wird pathItemCount auf undefiniert gesetzt, werden alle Elemente auf dem Pfad angezeigt.

Diese Eigenschaft bestimmt, wie sich die Elemente nach dem Ziehen oder Schieben ausrichten. Die möglichen Werte sind:

snapMode hat keine Auswirkungen auf currentIndex. Um currentIndex zu aktualisieren, wenn die Ansicht verschoben wird, setzen Sie highlightRangeMode auf PathView.StrictlyEnforceRange (Standardwert für PathView).

Siehe auch highlightRangeMode.

Diese angehängte Eigenschaft ist wahr, wenn dieser Delegat das aktuelle Element ist; andernfalls falsch.

Sie wird an jede Instanz des Delegaten angehängt.

Diese Eigenschaft kann verwendet werden, um das Aussehen des aktuellen Elements anzupassen.

    Component {
        id: delegate
        Column {
            id: wrapper

            required property url icon
            required property string name

            opacity: PathView.isCurrentItem ? 1 : 0.5

            Image {
                anchors.horizontalCenter: nameText.horizontalCenter
                width: 64; height: 64
                source: wrapper.icon
            }
            Text {
                id: nameText
                text: wrapper.name
                font.pointSize: 16
            }
        }
    }

Diese angehängte Eigenschaft gibt an, ob sich das Element derzeit auf dem Pfad befindet.

Wenn ein pathItemCount gesetzt wurde, ist es möglich, dass einige Elemente instanziiert werden, aber nicht als aktuell auf dem Pfad betrachtet werden. Normalerweise würden diese Elemente z. B. auf unsichtbar gesetzt werden:

Component {
    Rectangle {
        visible: PathView.onPath
        // ...
    }
}

Sie ist mit jeder Instanz des Delegaten verbunden.

Diese angehängte Eigenschaft enthält die Ansicht, die diese Delegateninstanz verwaltet.

Sie ist an jede Instanz des Delegaten angehängt.

Dieses Signal wird ausgegeben, wenn der Benutzer das Ziehen der Ansicht beendet.

Wenn die Geschwindigkeit des Ziehens zum Zeitpunkt des Loslassens der Touch-/Maustaste ausreichend ist, wird ein Flick ausgelöst.

Dieses Signal wird ausgegeben, wenn die Ansicht aufgrund einer Benutzerinteraktion zu ziehen beginnt.

Dieses Signal wird ausgegeben, wenn sich die Ansicht aufgrund eines Schnipsens nicht mehr bewegt.

Dieses Signal wird ausgegeben, wenn die Ansicht geschoben wird. Eine Bewegung beginnt ab dem Zeitpunkt, an dem die Maus oder die Berührung losgelassen wird, während sie noch in Bewegung ist.

Dieses Signal wird ausgegeben, wenn sich die Ansicht aufgrund einer Benutzerinteraktion nicht mehr bewegt. Wenn ein Flick erzeugt wurde, wird dieses Signal ausgegeben, sobald der Flick aufhört. Wurde kein Flick generiert, wird dieses Signal ausgegeben, wenn der Benutzer aufhört zu ziehen, d.h. wenn die Maus oder der Touch losgelassen wird.

Dieses Signal wird ausgegeben, wenn sich die Ansicht aufgrund einer Benutzerinteraktion zu bewegen beginnt.

Verringert den aktuellen Index.

Hinweis: Die Methoden sollten erst aufgerufen werden, wenn die Component abgeschlossen ist.

Erhöht den aktuellen Index.

Hinweis: Die Methoden sollten erst aufgerufen werden, nachdem die Komponente abgeschlossen ist.

Gibt den Index des Elements zurück, das den Punkt x enthält, y in Inhaltskoordinaten. Gibt es an dem angegebenen Punkt kein Element, wird -1 zurückgegeben.

Hinweis: Die Methoden sollten erst aufgerufen werden, wenn die Komponente abgeschlossen ist.

Gibt das Element zurück, das den Punkt x, y in Inhaltskoordinaten enthält. Befindet sich kein Element an dem angegebenen Punkt, wird null zurückgegeben.

Hinweis: Die Methoden sollten erst aufgerufen werden, nachdem die Komponente abgeschlossen ist.

Gibt das Element für index zurück. Wenn es für diesen Index kein Element gibt, z. B. weil es noch nicht erstellt wurde oder weil es aus dem sichtbaren Bereich geschwenkt und aus dem Cache entfernt wurde, wird null zurückgegeben.

Hinweis: Diese Methode sollte erst aufgerufen werden, wenn die Komponente abgeschlossen ist. Der zurückgegebene Wert sollte auch nicht gespeichert werden, da er zu null werden kann, sobald die Kontrolle den aufrufenden Bereich verlässt, wenn die Ansicht dieses Element freigibt.

Positioniert die Ansicht so, dass sich die index an der durch mode angegebenen Position befindet:

Hinweis: Die Methoden sollten erst aufgerufen werden, wenn die Component abgeschlossen ist. Um die Ansicht beim Starten zu positionieren, sollte diese Methode von Component.onCompleted aufgerufen werden. Zum Beispiel, um die Ansicht am Ende zu positionieren:

Component.onCompleted: positionViewAtIndex(count - 1, PathView.End)