XmlListModel QML Type

Zur Angabe eines Nur-Lese-Modells mit XML-Daten. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• count : int
• progress : real
• query : string
• roles : list<XmlListModelRole>
• source : url
• status : enumeration

Methoden

• errorString()
• reload()

Ausführliche Beschreibung

Um dieses Element zu verwenden, müssen Sie das Modul mit der folgenden Zeile importieren:

import QtQml.XmlListModel

XmlListModel wird verwendet, um ein Nur-Lese-Modell aus XML-Daten zu erstellen. Es kann als Datenquelle für Ansichtselemente (wie ListView, PathView, GridView) und andere Elemente, die mit Modelldaten interagieren (wie Repeater), verwendet werden.

Zum Beispiel, wenn es ein XML Dokument auf https://www.qt.io/blog/rss.xml wie dieses gibt:

<?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>

Ein XmlListModel könnte ein Modell aus diesen Daten erstellen, etwa so:

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" }
}

Der Wert query von "/rss/channel/item" gibt an, dass das XmlListModel ein Modellelement für jedes <item> im XML-Dokument erzeugen soll.

Die XmlListModelRole Objekte definieren die Attribute der Modellelemente. In diesem Fall hat jedes Modellelement die Attribute title, pubDate und link, die mit den Werten title, pubDate und link des entsprechenden <item> übereinstimmen. (Weitere Beispiele finden Sie in der Dokumentation XmlListModelRole.)

Das Modell könnte in einer ListView verwendet werden, etwa so:

ListView {
    width: 180; height: 300
    model: xmlModel
    delegate: Text { text: title + ": " + pubDate + "; link: " + link }
}

Die Daten von XmlListModel werden asynchron geladen, und status wird auf XmlListModel.Ready gesetzt, wenn das Laden abgeschlossen ist. Wenn XmlListModel für eine Ansicht verwendet wird, bedeutet dies, dass die Ansicht nicht gefüllt wird, bis das Modell geladen ist.

Eigenschaft Dokumentation

Methode Dokumentation