Ortsliste (QML)

Ausführen des Beispiels

Zum Ausführen des Beispiels von Qt Creatorauszuführen, öffnen Sie den Modus Welcome und wählen Sie das Beispiel unter Examples aus. Weitere Informationen finden Sie unter Erstellen und Ausführen eines Beispiels.

Das Beispiel Places List veranschaulicht die Suche nach einer Liste von Orten in einem bestimmten Gebiet und zeigt das Ergebnis unter Verwendung von ListView an. In diesem speziellen Fall wird eine Suche nach Orten durchgeführt, die mit dem Begriff food verknüpft sind.

Durchführen einer Ortssuche

Um eine QML-Anwendung zu schreiben, die Orte in einer Liste anzeigt, nehmen wir zunächst die folgenden Importdeklarationen vor.

import QtQuick
import QtPositioning
import QtLocation

Instanzieren Sie eine Plugin Instanz. Die Plugin ist quasi das Backend, von dem die Orte bezogen werden. Je nach Typ des Plugins müssen einige obligatorische Parameter ausgefüllt werden. Der wahrscheinlichste Typ von PluginParameter ist eine Form von Service Access Token, die im Service Plugin dokumentiert sind. In diesem Ausschnitt wird das Plugin osm verwendet, das keine weiteren Parameter benötigt:

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

Als Nächstes instanziieren wir ein PlaceSearchModel, das wir zur Angabe von Suchparametern und zur Durchführung eines Suchvorgangs nach Orten verwenden können. Zur Veranschaulichung wird update() aufgerufen, sobald die Konstruktion des Modells abgeschlossen ist. Normalerweise würde update() als Reaktion auf eine Benutzeraktion, wie z. B. das Anklicken einer Schaltfläche, aufgerufen werden.

PlaceSearchModel {
    id: searchModel

    plugin: myPlugin

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

    Component.onCompleted: update()

}

Schließlich instanziieren wir ein ListView, um die vom Modell gefundenen Suchergebnisse anzuzeigen. Es wurde ein Inline-Delegat verwendet und wir haben angenommen, dass jedes Suchergebnis von type PlaceSearchesult stammt. Folglich wird angenommen, dass wir immer Zugriff auf die Stelle role haben, andere Suchergebnistypen haben möglicherweise keine Stelle 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