ObjectModel QML Type

Définit un ensemble d'éléments destinés à servir de modèle. En savoir plus…

• Liste de tous les membres, y compris les membres hérités

Propriétés

• count : int

Propriétés associées

• index : int

Méthodes

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

Description détaillée

Un ObjectModel contient les éléments visuels à utiliser dans une vue. Lorsqu'un ObjectModel est utilisé dans une vue, celle-ci ne nécessite pas de délégué, car l'ObjectModel contient déjà le délégué visuel (les éléments).

Un élément peut déterminer son index au sein du modèle via la propriété attachée « index ».

L'exemple ci-dessous place trois rectangles colorés dans un ` 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
    }
}

Voir également Exemples d’Qt Quick: vues.

Documentation sur les propriétés

count : int [read-only]

Nombre d'éléments du modèle. Cette propriété est en lecture seule.

Documentation sur les propriétés associées

ObjectModel.index : int [attached]

Cette propriété associée contient l'index de l'élément de ce délégué au sein du modèle.

Elle est associée à chaque instance du délégué.

Documentation de la méthode

void append(object item)

Ajoute un nouvel item à la fin du modèle.

objectModel.append(objectComponent.createObject())

Voir également ` insert()` et ` remove()`.

void clear()

Supprime tous les éléments du modèle.

Voir également append() et remove().

QtObject get(int index)

Renvoie l’élément situé à l’adresse index dans le modèle. Cela permet d’accéder à cet élément ou de le modifier depuis JavaScript :

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

L'index doit être un élément de la liste.

Voir également append().

void insert(int index, object item)

Insère un nouvel élément « item » dans le modèle à la position index.

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

L'index doit concerner un élément existant de la liste, ou un élément situé au-delà de la fin de la liste (ce qui équivaut à une insertion en fin de liste).

Voir également ` append()` et ` remove()`.

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

Déplace les éléments n from d'une position to une autre.

Les plages « from » et « to » doivent exister ; par exemple, pour déplacer les 3 premiers éléments à la fin du modèle :

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

Voir aussi ` append()`.

void remove(int index, int n = 1)

Supprime du modèle les éléments de type « n » disponibles à l'adresse index.

Voir également clear().