XmlListModel QML Type
Para definir un modelo de solo lectura utilizando datos XML. Más información...
| Import Statement: | import QtQml.XmlListModel |
Propiedades
- count : int
- progress : real
- query : string
- roles : list<XmlListModelRole>
- source : url
- status : enumeration
Métodos
- string errorString()
- void reload()
Descripción detallada
Para utilizar este elemento, tendrás que importar el módulo con la siguiente línea:
import QtQml.XmlListModelXmlListModel se utiliza para crear un modelo de solo lectura a partir de datos XML. Se puede utilizar como fuente de datos para elementos de vista (como ListView, PathView o GridView) y otros elementos que interactúan con los datos del modelo (como Repeater).
Nota: Este modelo no admite consultas XPath. Admite rutas sencillas separadas por barras y, opcionalmente, un atributo por cada elemento.
Por ejemplo, si hay un documento XML en https://www.qt.io/blog/rss.xml como este:
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
...
<channel>
<item>
<title>Qt 6.0.2 Released</title>
<link>https://www.qt.io/blog/qt-6.0.2-released</link>
<pubDate>Wed, 03 Mar 2021 12:40:43 GMT</pubDate>
</item>
<item>
<title>Qt 6.1 Beta Released</title>
<link>https://www.qt.io/blog/qt-6.1-beta-released</link>
<pubDate>Tue, 02 Mar 2021 13:05:47 GMT</pubDate>
</item>
<item>
<title>Qt Creator 4.14.1 released</title>
<link>https://www.qt.io/blog/qt-creator-4.14.1-released</link>
<pubDate>Wed, 24 Feb 2021 13:53:21 GMT</pubDate>
</item>
</channel>
</rss>Un XmlListModel podría crear un modelo a partir de estos datos, de la siguiente manera:
import QtQml.XmlListModel
XmlListModel {
id: xmlModel
source: "https://www.qt.io/blog/rss.xml"
query: "/rss/channel/item"
XmlListModelRole { name: "title"; elementName: "title" }
XmlListModelRole { name: "pubDate"; elementName: "pubDate" }
XmlListModelRole { name: "link"; elementName: "link" }
}El valor «/rss/channel/item» de « query » especifica que el XmlListModel debe generar un elemento de modelo para cada « <item> » del documento XML.
Los objetos « XmlListModelRole » definen los atributos de los elementos del modelo. En este caso, cada elemento del modelo tendrá los atributos « title », « pubDate » y « link », que se corresponden con los valores « title », « pubDate » y « link » de su « <item> » correspondiente. (Consulte la documentación de XmlListModelRole para ver más ejemplos).
El modelo se podría utilizar en un ListView, de la siguiente manera:
ListView {
width: 180; height: 300
model: xmlModel
delegate: Text { text: title + ": " + pubDate + "; link: " + link }
}Los datos de ` XmlListModel ` se cargan de forma asíncrona, y ` status ` se establece en ` XmlListModel.Ready ` cuando finaliza la carga. Ten en cuenta que esto significa que, cuando se utiliza ` XmlListModel ` para una vista, esta no se rellena hasta que se haya cargado el modelo.
Documentación de propiedades
count : int
El número de registros de datos del modelo.
progress : real
Esto indica el progreso actual de la descarga de la fuente de datos XML. Este valor oscila entre 0,0 (no se han descargado datos) y 1,0 (se han descargado todos los datos). Si los datos XML no proceden de una fuente remota, el progreso pasa a ser 1,0 tan pronto como se leen los datos.
Ten en cuenta que, cuando el progreso es 1,0, los datos XML se han descargado, pero aún no se han cargado en el modelo. Utiliza la propiedad «status» para saber cuándo se han leído los datos XML y se han cargado en el modelo.
Véase también status y source.
query : string
Una cadena que representa la ruta base para crear elementos del modelo a partir de los objetos « XmlListModelRole » de este modelo. La consulta debe comenzar por '/'.
roles : list<XmlListModelRole>
Los roles que se pondrán a disposición para este modelo.
source : url
La ubicación de la fuente de datos XML.
status : enumeration
Especifica el estado de carga del modelo, que puede ser uno de los siguientes:
| Constante | Descripción |
|---|---|
XmlListModel.Null | No se han establecido datos XML para este modelo. |
XmlListModel.Ready | Los datos XML se han cargado en el modelo. |
XmlListModel.Loading | El modelo está leyendo y cargando datos XML. |
XmlListModel.Error | Se ha producido un error durante la carga del modelo. Consulta errorString() para obtener más detalles sobre el error. |
Véase también progress.
Documentación del método
string errorString()
Devuelve una cadena con la descripción del último error que se ha producido si ` status ` es un objeto de tipo ` XmlListModel.Error`.
void reload()
Vuelve a cargar el modelo.
© 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.