En esta página

DelegateModelGroup QML Type

Encapsula un conjunto filtrado de elementos de datos visuales. Más...

Import Statement: import QtQml.Models

Propiedades

Señales

  • changed(array removed, array inserted)

Métodos

  • void addGroups(int index, int count, list<string> groups)
  • var create(int index)
  • var create(jsdict data, array groups)
  • var create(int index, jsdict data, array groups)
  • var get(int index)
  • void insert(jsdict data, var groups)
  • void insert(int index, jsdict data, array groups)
  • void move(var from, var to, int count)
  • void remove(int index, int count)
  • void removeGroups(int index, int count, list<string> groups)
  • void resolve(int from, int to)
  • void setGroups(int index, int count, list<string> groups)

Descripción detallada

El tipo DelegateModelGroup permite acceder a los datos del modelo de los elementos delegados de un « DelegateModel », así como ordenar y filtrar dichos elementos delegados.

El conjunto inicial de elementos delegados instanciables en un « DelegateModel » viene representado por su grupo « items », que normalmente refleja directamente el contenido del modelo asignado a « DelegateModel::model ». Este conjunto puede modificarse para que refleje el contenido de cualquier otro miembro de « DelegateModel::groups » asignando el « name » de ese «DelegateModelGroup» a la propiedad « DelegateModel::filterOnGroup ».

Se puede acceder a los datos de un elemento de un DelegateModelGroup mediante la función get(), que devuelve información sobre la pertenencia al grupo y los índices, así como los datos del modelo. En combinación con la función move(), esto puede utilizarse para implementar la ordenación de vistas; con remove() para filtrar elementos de una vista; o con setGroups() y los delegados Package para clasificar los elementos en diferentes vistas. Los distintos grupos solo pueden ordenarse de forma independiente si son disyuntos. Al mover un elemento en un grupo, también se moverá en todos los demás grupos de los que forme parte.

Los datos de los modelos pueden complementarse insertando datos directamente en un `DelegateModelGroup` mediante la función ` insert()`. Esto puede utilizarse para introducir elementos simulados en una vista, o elementos de marcador de posición que posteriormente se resolved a datos reales del modelo cuando estén disponibles.

Los elementos delegados también pueden instanciarse directamente desde un `DelegateModelGroup` utilizando la función ` create()`, lo que permite utilizar la sustitución dinámica ( DelegateModel ) sin necesidad de un tipo de vista asociado o seleccionar elementos específicos que deben instanciarse, independientemente de si se encuentran actualmente dentro del área visible de una vista.

Véase también el tutorial sobre ordenación dinámica de vistas enQML.

Documentación de propiedades

count : int [read-only]

Esta propiedad contiene el número de elementos del grupo.

includeByDefault : bool

Esta propiedad determina si los nuevos elementos se asignan a este grupo de forma predeterminada.

name : string

Esta propiedad contiene el nombre del grupo.

Cada grupo de un modelo debe tener un nombre único que comience por una letra minúscula.

Documentación de Signal

changed(array removed, array inserted)

Esta señal se emite cuando se han eliminado o añadido elementos al grupo.

Cada objeto de las matrices ` removed ` y ` inserted ` tiene dos valores: el índice del primer elemento insertado o eliminado y un recuento del número de elementos consecutivos insertados o eliminados.

Cada índice se ajusta en función de los cambios anteriores, de modo que todos los elementos eliminados preceden a los insertados.

Nota: El controlador correspondiente es ` onChanged`.

Documentación del método

void addGroups(int index, int count, list<string> groups)

Añade los artículos de « count », que empiezan por « index », a « groups ».

var create(int index)

var create(int index, jsdict data, array groups = undefined)

var create(jsdict data, array groups = undefined)

Devuelve una referencia al elemento instanciado en index dentro del grupo.

Si se proporciona un objeto ` data `, se creará un ` inserted ` en ` index ` y se devolverá un elemento que haga referencia a esta nueva entrada. El parámetro opcional ` groups ` identifica los grupos a los que debe pertenecer la nueva entrada; si no se especifica, será el mismo grupo en el que se llamó a ` create()`.

Todos los elementos devueltos por create se añaden al grupo persistedItems. Los elementos de este grupo permanecen instanciados cuando no son referenciados por ninguna vista.

var get(int index)

Devuelve un objeto JavaScript que describe el elemento de index dentro del grupo.

El objeto devuelto contiene la misma información a la que tiene acceso un delegado desde el DelegateModel adjunto, así como el modelo de dicho elemento. Tiene las siguientes propiedades:

  • model: Los datos del modelo del elemento. Es lo mismo que la propiedad «model context» de un delegado
  • groups: una lista con los nombres de los grupos a los que pertenece el elemento. Se puede modificar esta propiedad para cambiar la pertenencia del elemento a los grupos.
  • inItems: indica si el elemento pertenece al grupo items. Al escribir en esta propiedad, se añadirá o eliminará el elemento del grupo.
  • itemsIndex: El índice del elemento dentro del grupo « items ».
  • in<GroupName> Indica si el elemento pertenece al grupo dinámico groupName. Al escribir en esta propiedad, se añadirá o se eliminará el elemento del grupo.
  • <groupName>Index: El índice del elemento dentro del grupo dinámico groupName.
  • isUnresolved Indica si el elemento está vinculado a un índice del modelo asignado a « DelegateModel::model ». Devuelve «true» si el elemento no está vinculado al modelo y «false» si lo está.

void insert(int index, jsdict data, array groups = undefined)

void insert(jsdict data, var groups = undefined)

Crea una nueva entrada en index en un DelegateModel con los valores de data que se corresponden con los roles del modelo asignados a DelegateModel::model.

Si no se proporciona ningún índice, los datos se añaden al final del modelo.

El parámetro opcional « groups » identifica los grupos a los que debe pertenecer la nueva entrada; si no se especifica, se considera igual al grupo en el que se llamó a la función «insert».

Los datos insertados en un ` DelegateModel ` pueden fusionarse posteriormente con una entrada existente en ` DelegateModel::model ` utilizando la función ` resolve()`. Esto puede utilizarse para crear elementos de marcador de posición que posteriormente se sustituyan por datos reales.

void move(var from, var to, int count)

Mueve « count » (en from ) dentro del grupo « to » a una nueva posición.

Nota: El DelegateModel actúa como un modelo proxy: contiene los delegados en un orden diferente al que tiene el underlying model. Cualquier cambio posterior en el modelo subyacente no deshará el reordenamiento que hayas realizado mediante esta función.

void remove(int index, int count)

Elimina del grupo los elementos de count que comienzan por index.

void removeGroups(int index, int count, list<string> groups)

Elimina los artículos de « count » que comienzan por « index » de « groups ».

void resolve(int from, int to)

Asigna un elemento sin resolver de from a un elemento de DelegateModel::model en el índice to.

Los elementos sin resolver son entradas cuyos datos se han « inserted » en un « DelegateModelGroup » en lugar de derivarse de un índice DelegateModel::model. Al resolver un elemento, este sustituirá al elemento del índice de destino por el elemento sin resolver. Un elemento resuelto reflejará los datos del modelo de origen en su índice vinculado y se desplazará cuando dicho índice se mueva, al igual que cualquier otro elemento.

Si se sustituye un nuevo elemento en el controlador onChanged() de DelegateModelGroup, su inserción y sustitución se comunicarán a las vistas como una operación atómica, creando la apariencia de que el contenido del modelo no ha cambiado, o si el elemento no resuelto y el del modelo no son adyacentes, de que el elemento previamente no resuelto simplemente se ha desplazado.

void setGroups(int index, int count, list<string> groups)

Modifica la pertenencia a grupos de los elementos de count a partir de index. Los elementos se eliminan de sus grupos actuales y se añaden a groups.

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