ObjectModel QML Type

Define un conjunto de elementos que se utilizarán como modelo. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• count : int

Propiedades anexas

• index : int

Métodos

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

Descripción detallada

Un ObjectModel contiene los elementos visuales que se utilizarán en una vista. Cuando se utiliza un ObjectModel en una vista, ésta no necesita un delegado, puesto que el ObjectModel ya contiene el delegado visual (elementos).

Un elemento puede determinar su índice dentro del modelo a través de la propiedad adjunta index.

El siguiente ejemplo coloca tres rectángulos de colores en 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
    }
}

Véase también Qt Quick Ejemplos - Vistas.

Documentación de propiedades

count : int [read-only]

El número de elementos en el modelo. Esta propiedad es de sólo lectura.

Documentación de la propiedad Attached

ObjectModel.index : int

Esta propiedad adjunta contiene el índice del elemento de este delegado dentro del modelo.

Se adjunta a cada instancia del delegado.

Documentación del método

void append(object item)

Añade un nuevo item al final del modelo.

objectModel.append(objectComponent.createObject())

Véase también insert() y remove().

void clear()

Borra todos los elementos del modelo.

Véase también append() y remove().

object get(int index)

Devuelve el elemento en index en el modelo. Esto permite acceder al elemento o modificarlo desde JavaScript:

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

index debe ser un elemento de la lista.

Véase también append().

void insert(int index, object item)

Inserta un nuevo item en el modelo en la posición index.

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

El index debe ser a un elemento existente en la lista, o uno pasado el final de la lista (equivalente a append).

Véase también append() y remove().

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

Mueve n elementos from una posición to otra.

Los rangos desde y hasta deben existir; por ejemplo, para mover los 3 primeros elementos al final del modelo:

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

Véase también append().

void remove(int index, int n = 1)

Elimina del modelo los elementos n en index.

Véase también clear().