En esta página

ObjectModel QML Type

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

Import Statement: import QtQml.Models

Propiedades

Propiedades adjuntas

Métodos

  • 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)

Descripción detallada

Un ObjectModel contiene los elementos visuales que se van a utilizar en una vista. Cuando se utiliza un ObjectModel en una vista, esta no necesita un delegado, ya que el ObjectModel ya contiene el delegado visual (elementos).

Un elemento puede determinar su índice dentro del modelo mediante la propiedad adjunta ` index `.

El ejemplo siguiente 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
    }
}

Tres rectángulos de colores apilados en un ListView

Véase también Ejemplos de «Qt Quick » - Vistas.

Documentación de la propiedad

count : int [read-only]

El número de elementos del modelo. Esta propiedad es de solo lectura.

Documentación de la propiedad adjunta

ObjectModel.index : int [attached]

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

Se asocia 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()

Elimina todos los elementos del modelo.

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

QtObject get(int index)

Devuelve el elemento situado en ` index ` del 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";
}

El ` 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 hacer referencia a un elemento existente en la lista o a uno situado más allá del final de la lista (equivalente a «añadir al final»).

Véanse 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 «from» y «to» deben existir; por ejemplo, para mover los tres 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 que se encuentran en index.

Véase también clear().

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