Ortsliste (QML)

Ausführen des Beispiels

Sie können das Beispiel wie folgt ausführen:

• Qt Creator

  Öffnen Sie den Modus „ Welcome “ und wählen Sie das Beispiel unter „ Examples “ aus. Weitere Informationen finden Sie unter Qt Creator: Tutorial: Erstellen und Ausführen.

• Qt Extension for Visual Studio Code

  Führen Sie den Befehl „ Qt: Open Qt examples “ über „ Command Palette “ aus und wählen Sie das Beispiel aus der Liste aus. Weitere Informationen finden Sie unter Qt Extension for Visual Studio Code: Tutorial: Erstellen und Ausführen.

Das Beispiel „ Places List “ veranschaulicht, wie man nach einer Liste von Orten in einem bestimmten Gebiet sucht und das Ergebnis mithilfe eines „ ListView “ anzeigt. In diesem speziellen Fall wird eine Suche nach Orten durchgeführt, die mit dem Begriff „ food “ in Verbindung stehen.

Durchführen einer Ortssuche

Um eine QML-Anwendung zu erstellen, die Orte in einer Liste anzeigt, beginnen wir mit den folgenden Import-Deklarationen.

import QtQuick
import QtPositioning
import QtLocation

Instanziieren Sie eine Instanz von „ Plugin “. „ Plugin “ ist im Grunde das Backend, aus dem die Orte bezogen werden. Je nach Art des Plugins müssen möglicherweise einige obligatorische Parameter angegeben werden. Bei „ PluginParameter “ handelt es sich höchstwahrscheinlich um eine Art Service-Zugriffstoken, das im jeweiligen Service-Plugin dokumentiert ist. In diesem Codeausschnitt wird das Plugin „ osm “ verwendet, das keine weiteren Parameter erfordert:

Plugin {
    id: myPlugin
    name: "osm"
    //specify plugin parameters as necessary
    //PluginParameter {...}
    //PluginParameter {...}
    //...
}

Als Nächstes instanziieren wir ein ` PlaceSearchModel `, mit dem wir Suchparameter festlegen und eine Suche nach Orten durchführen können. Zur Veranschaulichung wird ` update()` aufgerufen, sobald die Erstellung des Modells abgeschlossen ist. In der Regel würde ` update()` als Reaktion auf eine Benutzeraktion, wie beispielsweise einen Klick auf eine Schaltfläche, aufgerufen werden.

PlaceSearchModel {
    id: searchModel

    plugin: myPlugin

    searchTerm: "food"
    searchArea: QtPositioning.circle(startCoordinate, 5000 /* 5 km radius */);

    Component.onCompleted: update()

}

Abschließend instanziieren wir ein ` ListView `, um die vom Modell gefundenen Suchergebnisse anzuzeigen. Es wurde ein Inline-Delegat verwendet, und wir sind davon ausgegangen, dass jedes Suchergebnis vom Typ ` type ` ` PlaceSearchesult` ist. Folglich wird angenommen, dass wir immer Zugriff auf die `place `- role haben; andere Suchergebnistypen verfügen möglicherweise nicht über eine `place` - role.

ListView {
    anchors.fill: parent
    model: searchModel
    delegate: Component {
        Row {
            spacing: 5
            Marker { height: parent.height }
            Column {
                Text { text: title; font.bold: true }
                Text { text: place.location.address.text }
            }
        }
    }
}

Beispielprojekt @ code.qt.io