Repeater QML Type

Instanziiert eine Anzahl von Item-basierten Komponenten unter Verwendung eines bereitgestellten Modells. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• count : int
• delegate : Component
• model : var

Signale

• itemAdded(int index, Item item)
• itemRemoved(int index, Item item)

Methoden

• Item itemAt(index)

Detaillierte Beschreibung

Der Typ Repeater wird verwendet, um eine große Anzahl ähnlicher Elemente zu erstellen. Wie andere Ansichtstypen hat ein Repeater einen model und einen delegate: für jeden Eintrag im Modell wird der Delegat in einem mit Daten aus dem Modell gefüllten Kontext instanziiert. Ein Repeater-Element ist in der Regel von einem Positioner-Typ wie Row oder Column umschlossen, um die vom Repeater erstellten mehrfachen Delegaten-Elemente visuell zu positionieren.

Der folgende Repeater erstellt drei Instanzen eines Rectangle Elements innerhalb eines Row:

import QtQuick

Row {
    Repeater {
        model: 3
        Rectangle {
            width: 100; height: 40
            border.width: 1
            color: "yellow"
        }
    }
}

Die model eines Repeaters kann jedes der unterstützten Datenmodelle sein. Zusätzlich kann ein Repeater Delegat, wie Delegierte für andere Ansichten, auf seinen Index innerhalb des Repeaters zugreifen, sowie auf die Modelldaten die für den Delegaten relevant sind. Siehe die Dokumentation der delegate Eigenschaft für Details.

Elemente, die vom Repeater instanziiert werden, werden in der Reihenfolge als Kinder des Repeater-Elternteils eingefügt. Das Einfügen beginnt unmittelbar nach der Position des Repeaters in seiner übergeordneten Stapelliste. Auf diese Weise kann ein Repeater auch innerhalb eines Layouts verwendet werden. Im folgenden Beispiel werden die Elemente des Wiederholungsreglers zwischen einem roten und einem blauen Rechteck gestapelt:

Row {
    Rectangle { width: 10; height: 20; color: "red" }
    Repeater {
        model: 10
        Rectangle { width: 20; height: 20; radius: 10; color: "green" }
    }
    Rectangle { width: 10; height: 20; color: "blue" }
}

Überlegungen bei der Verwendung von Repeater

Der Repeater-Typ erstellt alle seine Delegatenelemente, wenn der Repeater zum ersten Mal erstellt wird. Dies kann ineffizient sein, wenn es eine große Anzahl von delegierten Elementen gibt und nicht alle Elemente gleichzeitig sichtbar sein müssen. In diesem Fall sollten Sie andere Ansichtstypen wie ListView verwenden (die delegierte Elemente nur erstellen, wenn sie in die Ansicht gescrollt werden) oder die Dynamic Object Creation Methoden verwenden, um Elemente nach Bedarf zu erstellen.

Beachten Sie auch, dass Repeater auf Item basiert und nur Item-abgeleitete Objekte wiederholen kann. Er kann zum Beispiel nicht verwendet werden, um QtObjects zu wiederholen:

// bad code:
Item {
    // Can't repeat QtObject as it doesn't derive from Item.
    Repeater {
        model: 10
        QtObject {}
    }
}

Eigenschaft Dokumentation

Column {
    Repeater {
        model: 10
        Text {
            required property int index
            text: "I'm item " + index
        }
    }
}

Column {
    Repeater {
        model: ["apples", "oranges", "pears"]
        Text {
            required property string modelData
            text: "Data: " + modelData
        }
    }
}

Signal Dokumentation

Dokumentation der Methode