ListView QML Type

Die Eigenschaft currentIndex enthält den Index des aktuellen Elements, und currentItem enthält das aktuelle Element. Wenn currentIndex auf -1 gesetzt wird, wird die Markierung gelöscht und currentItem auf Null gesetzt.

Wenn highlightFollowsCurrentItem gleich true ist, führt das Setzen einer dieser Eigenschaften zu einem sanften Scrollen von ListView, so dass das aktuelle Element sichtbar wird.

Beachten Sie, dass die Position des aktuellen Elements nur annähernd bestimmt werden kann, bis es in der Ansicht sichtbar wird.

Diese Eigenschaften definieren den bevorzugten Bereich der Hervorhebung (für das aktuelle Element) innerhalb der Ansicht. Der Wert preferredHighlightBegin muss kleiner als der Wert preferredHighlightEnd sein.

Diese Eigenschaften beeinflussen die Position des aktuellen Elements, wenn die Liste gescrollt wird. Wenn beispielsweise das aktuell ausgewählte Element in der Mitte der Liste verbleiben soll, wenn die Ansicht gescrollt wird, setzen Sie die Werte preferredHighlightBegin und preferredHighlightEnd auf die oberen und unteren Koordinaten, an denen sich das mittlere Element befinden würde. Wenn currentItem programmatisch geändert wird, wird die Liste automatisch so geblättert, dass sich das aktuelle Element in der Mitte der Ansicht befindet. Außerdem wird das Verhalten des aktuellen Elementindexes unabhängig davon erfolgen, ob eine Markierung vorhanden ist oder nicht.

Gültige Werte für highlightRangeMode sind:

Mit dieser Eigenschaft können Delegierte außerhalb der Ansichtsgeometrie angezeigt werden.

Wenn dieser Wert ungleich Null ist, erstellt die Ansicht zusätzliche Delegierte vor dem Beginn oder nach dem Ende der Ansicht. Die Ansicht erstellt so viele Delegierte, wie sie in die angegebene Pixelgröße passen kann.

Wenn zum Beispiel in einer vertikalen Ansicht der Delegierte 20 Pixel hoch ist und displayMarginBeginning und displayMarginEnd beide auf 40 gesetzt sind, werden 2 Delegierte oben und 2 Delegierte unten erstellt und angezeigt.

Der Standardwert ist 0.

Diese Eigenschaft ist dafür gedacht, bestimmte UI-Konfigurationen zu ermöglichen, und nicht als Leistungsoptimierung. Wenn Sie aus Leistungsgründen Delegates außerhalb der View-Geometrie erstellen möchten, sollten Sie stattdessen die Eigenschaft cacheBuffer verwenden.

Diese QML-Eigenschaft wurde in QtQuick 2.3 eingeführt.

Diese Eigenschaften steuern die Geschwindigkeit der Bewegungs- und Größenänderungsanimationen für das Highlight-Delegat.

highlightFollowsCurrentItem muss wahr sein, damit diese Eigenschaften Wirkung zeigen.

Der Standardwert für die Geschwindigkeitseigenschaften ist 400 Pixel/Sekunde. Der Standardwert für die Dauer-Eigenschaften ist -1, d.h. das Highlight benötigt so viel Zeit wie nötig, um sich mit der eingestellten Geschwindigkeit zu bewegen.

Diese Eigenschaften haben die gleichen Merkmale wie SmoothedAnimation: Wenn sowohl die Geschwindigkeit als auch die Dauer festgelegt sind, wird die Animation die kürzere Dauer verwenden.

Die Eigenschaften Geschwindigkeit und Dauer der Bewegung werden verwendet, um die Bewegung aufgrund von Indexänderungen zu steuern, zum Beispiel, wenn incrementCurrentIndex() aufgerufen wird. Wenn der Benutzer eine ListView anklickt, wird stattdessen die Geschwindigkeit des Anklickens zur Steuerung der Bewegung verwendet.

Um nur eine Eigenschaft zu setzen, kann die andere auf -1 gesetzt werden. Wenn Sie zum Beispiel nur die Dauer und nicht die Geschwindigkeit animieren möchten, verwenden Sie den folgenden Code:

highlightMoveDuration: 1000
highlightMoveVelocity: -1

Siehe auch highlightFollowsCurrentItem.

Diese Eigenschaft enthält den Übergang, der auf Elemente angewendet wird, die der Ansicht hinzugefügt werden.

Hier ist zum Beispiel eine Ansicht, die einen solchen Übergang festlegt:

ListView {
    ...
    add: Transition {
        NumberAnimation { properties: "x,y"; from: 100; duration: 1000 }
    }
}

Jedes Mal, wenn der obigen Ansicht ein Element hinzugefügt wird, wird das Element innerhalb einer Sekunde von der Position (100,100) zu seiner endgültigen x,y-Position innerhalb der Ansicht animiert. Der Übergang gilt nur für die neuen Elemente, die der Ansicht hinzugefügt werden; er gilt nicht für die Elemente darunter, die durch das Hinzufügen der neuen Elemente verschoben werden. Um die verdrängten Elemente zu animieren, legen Sie die Eigenschaften displaced oder addDisplaced fest.

Weitere Details und Beispiele für die Verwendung von Ansichtsübergängen finden Sie in der Dokumentation ViewTransition.

Siehe auch addDisplaced, populate, und ViewTransition.

Diese Eigenschaft enthält den Übergang, der auf Elemente innerhalb der Ansicht anzuwenden ist, die durch das Hinzufügen anderer Elemente zur Ansicht verschoben werden.

Hier ist zum Beispiel eine Ansicht, die einen solchen Übergang festlegt:

ListView {
    ...
    addDisplaced: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

Immer wenn ein Element zur obigen Ansicht hinzugefügt wird, werden alle Elemente unter dem neuen Element verschoben, wodurch sie sich innerhalb der Ansicht nach unten (oder seitwärts, wenn sie horizontal ausgerichtet sind) bewegen. Während diese Verschiebung stattfindet, wird die Bewegung der Elemente zu ihren neuen x,y-Positionen innerhalb der Ansicht durch eine NumberAnimation über eine Sekunde animiert, wie angegeben. Dieser Übergang wird nicht auf das neue Element angewendet, das der Ansicht hinzugefügt wurde; um die hinzugefügten Elemente zu animieren, setzen Sie die Eigenschaft add.

Wenn ein Element durch mehrere Arten von Operationen gleichzeitig verschoben wird, ist nicht definiert, ob der Übergang addDisplaced, moveDisplaced oder removeDisplaced angewendet wird. Wenn es nicht erforderlich ist, unterschiedliche Übergänge festzulegen, je nachdem, ob ein Element durch einen Hinzufügen-, Verschieben- oder Entfernen-Vorgang verschoben wird, sollten Sie stattdessen die Eigenschaft displaced festlegen.

Weitere Einzelheiten und Beispiele für die Verwendung von Ansichtsübergängen finden Sie in der Dokumentation ViewTransition.

Siehe auch displaced, add, populate, und ViewTransition.

Diese Eigenschaft bestimmt, ob Delegierte außerhalb des sichtbaren Bereichs der Ansicht beibehalten werden.

Wenn dieser Wert größer als Null ist, kann die Ansicht so viele instanziierte Delegierte behalten, wie sie in den angegebenen Puffer passen. Wenn zum Beispiel in einer vertikalen Ansicht der Delegierte 20 Pixel hoch ist und cacheBuffer auf 40 gesetzt ist, können bis zu 2 Delegierte oberhalb und 2 Delegierte unterhalb des sichtbaren Bereichs erstellt/beibehalten werden. Die gepufferten Delegaten werden asynchron erstellt, so dass die Erstellung über mehrere Frames hinweg erfolgen kann und die Wahrscheinlichkeit des Überspringens von Frames verringert wird. Um die Malleistung zu verbessern, werden Delegierte außerhalb des sichtbaren Bereichs nicht gezeichnet.

Der Standardwert dieser Eigenschaft ist plattformabhängig, ist aber normalerweise größer als Null. Negative Werte werden ignoriert.

Beachten Sie, dass cacheBuffer kein Pixelpuffer ist - er verwaltet nur zusätzliche instanziierte Delegates.

Der cacheBuffer arbeitet außerhalb der durch displayMarginBeginning oder displayMarginEnd festgelegten Anzeigeränder.

Die Eigenschaft spiegelt die Anzahl der Elemente im Modell von ListView wider, unabhängig davon, ob sie sichtbar sind oder als Item einer Delegatenkomponente instanziiert sind.

Diese Eigenschaft enthält den Abschnitt, der sich derzeit am Anfang der Ansicht befindet.

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 möglich, platzieren Sie Funktionalität, die für die normale Anzeige des Delegaten nicht benötigt wird, in einem Loader, das bei Bedarf zusätzliche Komponenten laden kann.

Die ListView wird die Elemente basierend auf der Größe des Stammelements im Delegaten anordnen.

Es wird empfohlen, dass die Größe des Delegaten eine ganze Zahl ist, um Sub-Pixel-Ausrichtung von Elementen zu vermeiden.

Der Standardwert stacking order für Delegateninstanzen ist 1.

Siehe auch Stacking Order in ListView.

Diese Eigenschaft enthält den generischen Übergang, der auf Elemente angewendet wird, die durch eine Modelloperation, die die Ansicht betrifft, verdrängt wurden.

Dies ist eine Bequemlichkeit, um den allgemeinen Übergang zu spezifizieren, der auf alle Elemente angewendet werden soll, die durch eine Hinzufügen-, Verschieben- oder Entfernen-Operation verdrängt werden, ohne dass die einzelnen Eigenschaften addDisplaced, moveDisplaced und removeDisplaced spezifiziert werden müssen. Hier ist zum Beispiel eine Ansicht, die einen verschobenen Übergang angibt:

ListView {
    ...
    displaced: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

Wenn ein Element in der obigen Ansicht hinzugefügt, verschoben oder entfernt wird, werden die Elemente darunter verschoben, so dass sie innerhalb der Ansicht nach unten (oder seitwärts, wenn sie horizontal ausgerichtet sind) verschoben werden. Während diese Verschiebung stattfindet, wird die Bewegung der Elemente zu ihren neuen x,y-Positionen innerhalb der Ansicht durch eine NumberAnimation über eine Sekunde animiert, wie angegeben.

Wenn eine Ansicht sowohl diesen allgemeinen Verschiebungsübergang als auch einen spezifischen addDisplaced, moveDisplaced oder removeDisplaced Übergang angibt, wird der spezifischere Übergang anstelle des allgemeinen Verschiebungsübergangs verwendet, wenn der entsprechende Vorgang stattfindet, vorausgesetzt, der spezifischere Übergang wurde nicht deaktiviert (indem enabled auf false gesetzt wurde). Wenn dies der Fall ist, wird stattdessen der generische Übergang "displaced" verwendet.

Weitere Einzelheiten und Beispiele für die Verwendung von Ansichtsübergängen finden Sie in der Dokumentation ViewTransition.

Siehe auch addDisplaced, moveDisplaced, removeDisplaced, und ViewTransition.

Diese Eigenschaft enthält die effektive Layout-Richtung einer horizontal orientierten Liste.

Wenn Sie die angehängte Eigenschaft LayoutMirroring::enabled für Gebietsschema-Layouts verwenden, wird die visuelle Layoutrichtung der horizontalen Liste gespiegelt. Die Eigenschaft layoutDirection bleibt jedoch unverändert.

Siehe auch ListView::layoutDirection und LayoutMirroring.

Diese Eigenschaft enthält die Komponente, die als Fußzeile verwendet werden soll.

Für jede Ansicht wird eine Instanz der Fußzeilenkomponente erstellt. Die Fußzeile wird am Ende der Ansicht positioniert, nach allen Elementen. Die Standardeinstellung stacking order für die Fußzeile ist 1.

Siehe auch header, footerItem, und Stacking Order in ListView.

Diese enthält das Fußzeilenelement, das aus der Komponente footer erstellt wurde.

Für jede Ansicht wird eine Instanz der Fußzeilen-Komponente erstellt. Die Fußzeile wird am Ende der Ansicht positioniert, nach allen Elementen. Der Standardwert stacking order für die Fußzeile ist 1.

Siehe auch footer, headerItem, und Stacking Order in ListView.

Diese Eigenschaft bestimmt die Positionierung der footer item.

Diese Eigenschaft wurde in Qt 5.4 eingeführt.

Diese Eigenschaft enthält die Komponente, die als Kopfzeile verwendet werden soll.

Eine Instanz der Header-Komponente wird für jede Ansicht erstellt. Die Kopfzeile wird am Anfang der Ansicht positioniert, vor allen Elementen. Die Standardeinstellung stacking order für die Kopfzeile ist 1.

Siehe auch footer, headerItem, und Stacking Order in ListView.

Diese enthält die Kopfzeile, die aus der Komponente header erstellt wurde.

Für jede Ansicht wird eine Instanz der Header-Komponente erstellt. Die Kopfzeile wird am Anfang der Ansicht positioniert, vor allen anderen Elementen. Der Standardwert stacking order für die Kopfzeile ist 1.

Siehe auch header, footerItem, und Stacking Order in ListView.

Diese Eigenschaft bestimmt die Positionierung der header item.

Diese Eigenschaft wurde in Qt 5.4 eingeführt.

Diese Eigenschaft enthält die Komponente, die als Highlight verwendet werden soll.

Eine Instanz der Highlight-Komponente wird für jede Liste erstellt. Die Geometrie der resultierenden Komponenteninstanz wird von der Liste so verwaltet, dass sie beim aktuellen Element bleibt, es sei denn, die Eigenschaft highlightFollowsCurrentItem ist falsch. Die Standardeinstellung stacking order für das Highlight-Element ist 0.

Siehe auch highlightItem, highlightFollowsCurrentItem, ListView Highlight Example, und Stacking Order in ListView.

Diese Eigenschaft gibt an, ob das Highlight von der Ansicht verwaltet wird.

Wenn diese Eigenschaft true ist (der Standardwert), wird die Hervorhebung fließend bewegt, um dem aktuellen Element zu folgen. Andernfalls wird das Highlight nicht von der Ansicht bewegt, und jede Bewegung muss vom Highlight selbst ausgeführt werden.

Hier sehen Sie ein Highlight, dessen Bewegung durch ein SpringAnimation -Element definiert ist:

Component {
    id: highlight
    Rectangle {
        width: 180; height: 40
        color: "lightsteelblue"; radius: 5
        y: list.currentItem.y
        Behavior on y {
            SpringAnimation {
                spring: 3
                damping: 0.2
            }
        }
    }
}

ListView {
    id: list
    width: 180; height: 200
    model: ContactModel {}
    delegate: Text { text: name }

    highlight: highlight
    highlightFollowsCurrentItem: false
    focus: true
}

Beachten Sie, dass die Animation der Hervorhebung auch die Art und Weise beeinflusst, wie die Ansicht gescrollt wird. Das liegt daran, dass sich die Ansicht bewegt, um die Markierung innerhalb des bevorzugten Markierungsbereichs (oder des sichtbaren Ansichtsbereichs) zu halten.

Siehe auch highlight und highlightMoveVelocity.

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

Die highlightItem wird von der Ansicht verwaltet, es sei denn, highlightFollowsCurrentItem ist auf false gesetzt. Der Standardwert stacking order des Hervorhebungselements ist 0.

Siehe auch highlight, highlightFollowsCurrentItem, und Stacking Order in ListView.

Diese Eigenschaft gibt an, ob die Tastennavigation in der Liste aktiviert ist.

Wenn dies true ist, kann der Benutzer mit der Tastatur in der Ansicht navigieren. Dies ist nützlich für Anwendungen, die die Maus- und Tastaturinteraktion selektiv aktivieren oder deaktivieren müssen.

Standardmäßig ist der Wert dieser Eigenschaft an interactive gebunden, um die Verhaltenskompatibilität für bestehende Anwendungen zu gewährleisten. Wenn sie explizit gesetzt wird, ist sie nicht mehr an die interaktive Eigenschaft gebunden.

Siehe auch interactive.

Diese Eigenschaft legt fest, ob die Liste die Tastennavigation umschließt.

Wenn dies der Fall ist, wird die Tastennavigation, die die aktuelle Elementauswahl über das Ende der Liste hinaus verschieben würde, umbrochen und die Auswahl an den Anfang der Liste verschoben und umgekehrt.

Standardmäßig wird die Tastennavigation nicht umbrochen.

Diese Eigenschaft gibt die Layoutrichtung einer horizontal ausgerichteten Liste an.

Mögliche Werte:

Die Einstellung dieser Eigenschaft hat keine Auswirkung, wenn die orientation Qt.Vertical ist.

Siehe auch ListView::effectiveLayoutDirection und ListView::verticalLayoutDirection.

Diese Eigenschaft enthält das Modell, das die Daten für die Liste liefert.

Das Modell stellt den Datensatz bereit, der zur Erstellung der Elemente in der Ansicht verwendet wird. Modelle können direkt in QML mit ListModel, ObjectModel erstellt oder durch C++-Modellklassen bereitgestellt werden. Wenn eine C++-Modellklasse verwendet wird, muss sie eine Unterklasse von QAbstractItemModel oder eine einfache Liste sein.

Siehe auch Datenmodelle.

Diese Eigenschaft enthält den Übergang, der auf Elemente in der Ansicht anzuwenden ist, die aufgrund einer Verschiebeoperation in der Ansicht model verschoben werden.

Hier ist zum Beispiel eine Ansicht, die einen solchen Übergang festlegt:

ListView {
    ...
    move: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

Immer wenn model eine Verschiebeoperation ausführt, um einen bestimmten Satz von Indizes zu verschieben, werden die entsprechenden Elemente in der Ansicht eine Sekunde lang zu ihren neuen Positionen in der Ansicht animiert. Der Übergang gilt nur für die Elemente, die Gegenstand der Verschiebeoperation im Modell sind; er gilt nicht für die Elemente darunter, die durch die Verschiebeoperation verschoben werden. Um die verschobenen Elemente zu animieren, legen Sie die Eigenschaften displaced oder moveDisplaced fest.

Weitere Details und Beispiele für die Verwendung von Ansichtsübergängen finden Sie in der Dokumentation ViewTransition.

Siehe auch moveDisplaced und ViewTransition.

Diese Eigenschaft enthält den Übergang, der auf Elemente angewendet werden soll, die durch eine Verschiebeoperation in der Ansicht model verschoben werden.

Hier ist zum Beispiel eine Ansicht, die einen solchen Übergang festlegt:

ListView {
    ...
    moveDisplaced: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

Immer wenn model eine Verschiebeoperation durchführt, um einen bestimmten Satz von Indizes zu verschieben, werden die Elemente zwischen den Quell- und Zielindizes der Verschiebeoperation verschoben, wodurch sie sich innerhalb der Ansicht nach oben oder unten (oder seitwärts, wenn sie horizontal ausgerichtet sind) bewegen. Während diese Verschiebung stattfindet, wird die Bewegung der Elemente zu ihren neuen x,y-Positionen innerhalb der Ansicht durch eine NumberAnimation über eine Sekunde animiert, wie angegeben. Dieser Übergang wird nicht auf die Elemente angewandt, die der eigentliche Gegenstand des Verschiebevorgangs sind; um die verschobenen Elemente zu animieren, setzen Sie die Eigenschaft move.

Wenn ein Element durch mehrere Arten von Operationen gleichzeitig verschoben wird, ist nicht definiert, ob der Übergang addDisplaced, moveDisplaced oder removeDisplaced angewendet wird. Wenn es nicht notwendig ist, unterschiedliche Übergänge festzulegen, je nachdem, ob ein Element durch einen Hinzufügen-, Verschieben- oder Entfernen-Vorgang verschoben wird, sollten Sie stattdessen die Eigenschaft displaced verwenden.

Weitere Einzelheiten und Beispiele für die Verwendung von Ansichtsübergängen finden Sie in der Dokumentation ViewTransition.

Siehe auch displaced, move, und ViewTransition.

Diese Eigenschaft gibt die Ausrichtung der Liste an.

Mögliche Werte:

Konstant	Beschreibung
ListView.Horizontal	Elemente werden horizontal angeordnet
ListView.Vertical	(Standard) Die Elemente werden vertikal angeordnet.

Siehe auch Flickable Direction.

Diese Eigenschaft enthält den Übergang, der auf die Elemente angewendet wird, die anfänglich für eine Ansicht erstellt werden.

Sie wird auf alle Elemente angewendet, die erstellt werden, wenn:

• Die Ansicht zum ersten Mal erstellt wird
• Die model der Ansicht ändert sich so, dass die sichtbaren Delegierten vollständig ersetzt werden
• Die model der Ansicht ist reset, wenn das Modell eine QAbstractItemModel Unterklasse ist.

Hier ist zum Beispiel eine Ansicht, die einen solchen Übergang spezifiziert:

ListView {
    ...
    populate: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

Wenn die Ansicht initialisiert wird, erstellt die Ansicht alle notwendigen Elemente für die Ansicht und animiert sie dann eine Sekunde lang zu ihren richtigen Positionen innerhalb der Ansicht.

Wenn die Ansicht jedoch später gescrollt wird, wird der Populate-Übergang nicht ausgeführt, obwohl die Delegaten instanziiert werden, sobald sie sichtbar werden. Wenn sich das Modell so ändert, dass neue Delegierte sichtbar werden, wird der Übergang add ausgeführt. Sie sollten sich also nicht auf den Übergang populate verlassen, um Eigenschaften im Delegaten zu initialisieren, da er nicht für jeden Delegaten gilt. Wenn Ihre Animation den to Wert einer Eigenschaft festlegt, sollte die Eigenschaft anfangs den to Wert haben, und die Animation sollte den from Wert festlegen, falls sie animiert wird:

ListView {
    ...
    delegate: Rectangle {
        opacity: 1 // not necessary because it's the default
    }
    populate: Transition {
        NumberAnimation { property: "opacity"; from: 0; to: 1; duration: 1000 }
    }
}

Weitere Details und Beispiele für die Verwendung von Ansichtsübergängen finden Sie in der Dokumentation ViewTransition.

Siehe auch add und ViewTransition.

Diese Eigenschaft enthält den Übergang, der auf Elemente angewendet wird, die aus der Ansicht entfernt werden.

Hier ist zum Beispiel eine Ansicht, die einen solchen Übergang festlegt:

ListView {
    ...
    remove: Transition {
        ParallelAnimation {
            NumberAnimation { property: "opacity"; to: 0; duration: 1000 }
            NumberAnimation { properties: "x,y"; to: 100; duration: 1000 }
        }
    }
}

Immer, wenn ein Element aus der obigen Ansicht entfernt wird, wird das Element eine Sekunde lang zur Position (100,100) animiert, und parallel dazu ändert sich auch seine Deckkraft auf 0. Der Übergang gilt nur für die Elemente, die aus der Ansicht entfernt werden; er gilt nicht für die Elemente darunter, die durch das Entfernen der Elemente verschoben werden. Um die verdrängten Elemente zu animieren, stellen Sie die Eigenschaften displaced oder removeDisplaced ein.

Beachten Sie, dass zu dem Zeitpunkt, an dem der Übergang angewendet wird, das Element bereits aus dem Modell entfernt wurde; alle Verweise auf die Modelldaten für den entfernten Index sind dann nicht mehr gültig.

Wenn außerdem die Eigenschaft delayRemove für ein Delegatenelement festgelegt wurde, wird der Übergang zum Entfernen erst dann angewendet, wenn delayRemove wieder auf false gesetzt wird.

Weitere Details und Beispiele für die Verwendung von Ansichtsübergängen finden Sie in der Dokumentation ViewTransition.

Siehe auch removeDisplaced und ViewTransition.

Diese Eigenschaft enthält den Übergang, der auf Elemente in der Ansicht angewendet werden soll, die durch das Entfernen anderer Elemente in der Ansicht verdrängt werden.

Hier ist zum Beispiel eine Ansicht, die einen solchen Übergang festlegt:

ListView {
    ...
    removeDisplaced: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

Immer wenn ein Element aus der obigen Ansicht entfernt wird, werden alle darunter liegenden Elemente verschoben, so dass sie sich innerhalb der Ansicht nach oben (oder seitwärts, wenn sie horizontal ausgerichtet sind) bewegen. Während diese Verschiebung stattfindet, wird die Bewegung der Objekte zu ihren neuen x,y-Positionen innerhalb der Ansicht durch eine NumberAnimation über eine Sekunde animiert, wie angegeben. Dieser Übergang wird nicht auf das Element angewendet, das tatsächlich aus der Ansicht entfernt wurde; um die entfernten Elemente zu animieren, setzen Sie die Eigenschaft remove.

Wenn ein Element durch mehrere Arten von Operationen gleichzeitig verschoben wird, ist nicht definiert, ob der Übergang addDisplaced, moveDisplaced oder removeDisplaced angewendet wird. Wenn es nicht erforderlich ist, unterschiedliche Übergänge festzulegen, je nachdem, ob ein Element durch einen Hinzufügen-, Verschieben- oder Entfernen-Vorgang verschoben wird, sollten Sie stattdessen die Eigenschaft displaced festlegen.

Weitere Details und Beispiele für die Verwendung von Ansichtsübergängen finden Sie in der Dokumentation ViewTransition.

Siehe auch displaced, remove, und ViewTransition.

Mit dieser Eigenschaft können Sie Elemente wiederverwenden, die aus delegate instanziiert wurden. Wenn Sie diese Eigenschaft auf false setzen, werden alle derzeit gepoolten Elemente zerstört.

Diese Eigenschaft ist standardmäßig auf false eingestellt.

Siehe auch Reusing items, pooled(), und reused().

Diese Eigenschaften bestimmen den auszuwertenden Ausdruck und das Aussehen der Abschnittsbezeichnungen.

section.property enthält den Namen der Eigenschaft, die die Grundlage für jeden Abschnitt bildet.

section.criteria enthält die Kriterien für die Bildung jedes Abschnitts auf der Grundlage von section.property. Dieser Wert kann einer der folgenden sein:

Bei der Bestimmung der Abschnittsgrenzen wird die Groß- und Kleinschreibung nicht berücksichtigt.

section.delegate enthält die Delegatenkomponente für jeden Abschnitt. Der Standardwert stacking order von Abschnittsdelegaten ist 2. Wenn Sie eine required Eigenschaft mit dem Namen "Abschnitt" darin deklarieren, enthält diese Eigenschaft den Titel des Abschnitts.

section.labelPositioning bestimmt, ob die Beschriftungen des aktuellen und/oder nächsten Abschnitts am Anfang/Ende der Ansicht haften und ob die Beschriftungen inline angezeigt werden. Dieser Wert kann eine Kombination aus sein:

Jedes Element in der Liste hat angehängte Eigenschaften mit den Namen ListView.section, ListView.previousSection und ListView.nextSection.

Hier ist zum Beispiel eine ListView, die eine Liste von Tieren anzeigt, die in Abschnitte unterteilt sind. Jedes Element in ListView wird in einem anderen Abschnitt platziert, abhängig von der Eigenschaft "Größe" des Modellelements. Die Delegatenkomponente sectionHeading stellt den hellblauen Balken bereit, der den Beginn jedes Abschnitts markiert.

    // The delegate for each section header
    Component {
        id: sectionHeading
        Rectangle {
            width: ListView.view.width
            height: childrenRect.height
            color: "lightsteelblue"

            required property string section

            Text {
                text: parent.section
                font.bold: true
                font.pixelSize: 20
            }
        }
    }

    ListView {
        id: view
        anchors.top: parent.top
        anchors.bottom: buttonBar.top
        width: parent.width
        model: animalsModel
        delegate: Text {
            required property string name

            text: name
            font.pixelSize: 18
        }

        section.property: "size"
        section.criteria: ViewSection.FullString
        section.delegate: sectionHeading
    }

Siehe auch ListView-Beispiele und Stacking Order in ListView.

Diese Eigenschaft legt fest, wie sich der Bildlauf der Ansicht nach dem Ziehen oder Schieben einpendelt. Die möglichen Werte sind:

snapMode Der Wert currentIndex wird nicht beeinflusst. Um currentIndex zu aktualisieren, wenn die Liste verschoben wird, setzen Sie highlightRangeMode auf ListView.StrictlyEnforceRange.

Siehe auch highlightRangeMode.

Diese Eigenschaft enthält den Abstand zwischen den Elementen.

Der Standardwert ist 0.

Diese Eigenschaft gibt die Layoutrichtung einer vertikal orientierten Liste an.

Mögliche Werte:

Die Einstellung dieser Eigenschaft hat keine Auswirkung, wenn die orientation Qt.Horizontal ist.

Siehe auch ListView::layoutDirection.

Diese Attached-Eigenschaft gibt an, ob der Delegat zerstört werden kann. Sie wird an jede Instanz des Delegaten angehängt. Der Standardwert ist false.

Es ist manchmal notwendig, die Zerstörung eines Elements zu verzögern, bis eine Animation abgeschlossen ist. Der folgende Beispieldelegat stellt sicher, dass die Animation abgeschlossen ist, bevor das Element aus der Liste entfernt wird.

Component {
    id: delegate
    Item {
        SequentialAnimation {
            id: removeAnimation
            PropertyAction { target: wrapper; property: "ListView.delayRemove"; value: true }
            NumberAnimation { target: wrapper; property: "scale"; to: 0; duration: 250; easing.type: Easing.InOutQuad }
            PropertyAction { target: wrapper; property: "ListView.delayRemove"; value: false }
        }
        ListView.onRemove: removeAnimation.start()
    }
}

Wenn ein Übergang remove angegeben wurde, wird er erst angewendet, wenn delayRemove an false zurückgegeben wird.

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

Sie wird an jede Instanz des Delegaten angehängt.

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

ListView {
    width: 180; height: 200

    Component {
        id: contactsDelegate
        Rectangle {
            id: wrapper
            width: 180
            height: contactInfo.height
            color: ListView.isCurrentItem ? "black" : "red"
            Text {
                id: contactInfo
                text: name + ": " + number
                color: wrapper.ListView.isCurrentItem ? "red" : "black"
            }
        }
    }

    model: ContactModel {}
    delegate: contactsDelegate
    focus: true
}

Diese angehängte Eigenschaft enthält den Abschnitt des nächsten Elements.

Sie wird an jede Instanz des Delegaten angehängt.

Der Abschnitt wird mit Hilfe der section Eigenschaften ausgewertet.

Diese angehängte Eigenschaft enthält den Abschnitt des vorherigen Elements.

Sie ist an jede Instanz des Delegaten angehängt.

Der Abschnitt wird unter Verwendung der section Eigenschaften ausgewertet.

Diese angehängte Eigenschaft enthält den Abschnitt dieses Elements.

Sie ist an jede Instanz des Delegaten angehängt.

Der Abschnitt wird mit den Eigenschaften section ausgewertet.

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

Sie ist an jede Instanz des Delegaten und auch an die Kopfzeile, die Fußzeile, den Abschnitt und die Hervorhebungsdelegaten angehängt.

Dieses angehängte Signal wird unmittelbar nach dem Hinzufügen eines Elements zur Ansicht ausgegeben.

Wenn ein Hinzufügungsübergang angegeben ist, wird dieser unmittelbar nach der Behandlung dieses Signals angewendet.

Dieses Signal wird ausgegeben, nachdem ein Element zum Wiederverwendungspool hinzugefügt wurde. Sie können es verwenden, um laufende Timer oder Animationen innerhalb des Objekts anzuhalten oder um Ressourcen freizugeben, die nicht wiederverwendet werden können.

Dieses Signal wird nur ausgegeben, wenn die Eigenschaft reuseItems true lautet.

Siehe auch Reusing items, reuseItems, und reused().

Dieses angehängte Signal wird ausgegeben, unmittelbar bevor ein Element aus der Ansicht entfernt wird.

Wenn ein Übergang zum Entfernen angegeben wurde, wird er nach der Behandlung dieses Signals angewendet, vorausgesetzt, dass delayRemove falsch ist.

Dieses Signal wird ausgegeben, nachdem ein Element wiederverwendet wurde. Zu diesem Zeitpunkt wurde das Element aus dem Pool genommen und in der Inhaltsansicht platziert, und die Modelleigenschaften wie index und row wurden aktualisiert.

Andere Eigenschaften, die nicht vom Modell bereitgestellt werden, ändern sich nicht, wenn ein Element wiederverwendet wird. Sie sollten es vermeiden, irgendeinen Zustand innerhalb eines Delegaten zu speichern, aber wenn Sie es doch tun, setzen Sie diesen Zustand beim Empfang dieses Signals manuell zurück.

Dieses Signal wird ausgegeben, wenn das Element wiederverwendet wird, und nicht, wenn das Element zum ersten Mal erstellt wird.

Dieses Signal wird nur ausgegeben, wenn die Eigenschaft reuseItems true lautet.

Siehe auch Reusing items, reuseItems, und pooled().

Positioniert die Ansicht an den Anfang oder das Ende, unter Berücksichtigung von Kopf- oder Fußzeilen.

Es wird nicht empfohlen, contentX oder contentY zu verwenden, um die Ansicht an einem bestimmten Index zu positionieren. Dies ist unzuverlässig, da das Entfernen von Elementen vom Anfang der Liste nicht dazu führt, dass alle anderen Elemente neu positioniert werden, und weil der tatsächliche Anfang der Ansicht je nach Größe der Delegierten variieren kann.

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 beim Starten am Ende zu positionieren:

Component.onCompleted: positionViewAtEnd()

Verringert den aktuellen Index. Der aktuelle Index wird umbrochen, wenn keyNavigationWraps wahr ist und er sich am Anfang befindet. Diese Methode hat keine Auswirkung, wenn count gleich Null ist.

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

Das Reagieren auf Änderungen im Modell wird in der Regel nur einmal pro Frame ausgelöst. Das bedeutet, dass es innerhalb von Skriptblöcken möglich ist, dass sich das zugrundeliegende Modell geändert hat, die ListView aber noch nicht aufgeschlossen hat.

Diese Methode zwingt ListView dazu, sofort auf alle ausstehenden Änderungen im Modell zu reagieren.

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

Erhöht den aktuellen Index. Der aktuelle Index wird umbrochen, wenn keyNavigationWraps wahr ist und er sich gerade am Ende befindet. Diese Methode hat keine Wirkung, wenn count gleich Null ist.

Hinweis: Die Methoden sollten erst aufgerufen werden, nachdem die Komponente fertiggestellt wurde.

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

Befindet sich das Element außerhalb des sichtbaren Bereichs, wird -1 zurückgegeben, unabhängig davon, ob ein Element an diesem Punkt vorhanden ist, wenn es in die Ansicht gescrollt wird.

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

Gibt das sichtbare Element zurück, das den Punkt x, y in Inhaltskoordinaten enthält. Wenn es an dem angegebenen Punkt kein Element gibt oder das Element nicht sichtbar ist, wird null zurückgegeben.

Wenn das Element außerhalb des sichtbaren Bereichs liegt, wird null zurückgegeben, unabhängig davon, ob ein Element an diesem Punkt vorhanden ist, wenn es in die Ansicht gescrollt wird.

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

Gibt das Element für index zurück. Wenn es für diesen Index kein Element gibt, weil es beispielsweise 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:

Wenn die Positionierung der Ansicht bei index dazu führen würde, dass am Anfang oder Ende der Ansicht leerer Raum angezeigt wird, wird die Ansicht an der Grenze positioniert.

Es wird nicht empfohlen, contentX oder contentY zu verwenden, um die Ansicht an einem bestimmten Index zu positionieren. Dies ist unzuverlässig, da das Entfernen von Elementen vom Anfang der Liste nicht dazu führt, dass alle anderen Elemente neu positioniert werden, und weil der tatsächliche Anfang der Ansicht je nach Größe der Delegierten variieren kann. Der korrekte Weg, ein Element in die Ansicht zu bringen, ist positionViewAtIndex.

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, ListView.Beginning)