ObjectModel QML Type

Definiert einen Satz von Elementen, die als Modell verwendet werden sollen. Mehr...

Import Statement: import QtQml.Models

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

count : int

Beigefügte Eigenschaften

index : int

Methoden

append(object item)
clear()
object get(int index)
insert(int index, object item)
move(int from, int to, int n)
remove(int index, int n)

Ausführliche Beschreibung

Ein ObjectModel enthält die visuellen Elemente, die in einer Ansicht verwendet werden sollen. Wenn ein ObjectModel in einer Ansicht verwendet wird, benötigt die Ansicht keinen Delegaten, da das ObjectModel bereits den visuellen Delegaten (Elemente) enthält.

Ein Element kann seinen Index innerhalb des Modells über die angehängte Eigenschaft index bestimmen.

Das folgende Beispiel platziert drei farbige Rechtecke in einer ListView.

import QtQuick 2.0
import QtQml.Models 2.1

Rectangle {
    ObjectModel {
        id: itemModel
        Rectangle { height: 30; width: 80; color: "red" }
        Rectangle { height: 30; width: 80; color: "green" }
        Rectangle { height: 30; width: 80; color: "blue" }
    }

    ListView {
        anchors.fill: parent
        model: itemModel
    }
}

Siehe auch Qt Quick Beispiele - Ansichten.

Eigenschaft Dokumentation

count : int [read-only]

Die Anzahl der Elemente im Modell. Diese Eigenschaft ist schreibgeschützt.

Angehängte Eigenschaft Dokumentation

ObjectModel.index : int

Diese angehängte Eigenschaft enthält den Index des Elements dieses Delegaten innerhalb des Modells.

Sie ist an jede Instanz des Delegaten angehängt.

Methode Dokumentation

append(object item)

Hängt eine neue item an das Ende des Modells an.

objectModel.append(objectComponent.createObject())

Siehe auch insert() und remove().

clear()

Löscht alle Elemente aus dem Modell.

Siehe auch append() und remove().

object get(int index)

Gibt das Element unter index im Modell zurück. Dies ermöglicht den Zugriff auf das Element oder dessen Änderung über JavaScript:

Component.onCompleted: {
    objectModel.append(objectComponent.createObject())
    console.log(objectModel.get(0).objectName);
    objectModel.get(0).objectName = "first";
}

Die Adresse index muss ein Element in der Liste sein.

Siehe auch append().

insert(int index, object item)

Fügt ein neues item an der Position index in das Modell ein.

objectModel.insert(2, objectComponent.createObject())

Die index muss zu einem bestehenden Element in der Liste gehören oder hinter dem Ende der Liste liegen (entspricht append).

Siehe auch append() und remove().

move(int from, int to, int n = 1)

Verschiebt n Elemente from eine Position to eine andere.

Die Bereiche from und to müssen vorhanden sein; zum Beispiel, um die ersten 3 Elemente an das Ende des Modells zu verschieben:

objectModel.move(0, objectModel.count - 3, 3)

Siehe auch append().

remove(int index, int n = 1)

Entfernt n Elemente unter index aus dem Modell.

Siehe auch clear().

© 2025 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.