QGeoPath Class
Die Klasse „QGeoPath“ definiert einen geografischen Pfad. Mehr...
| Header: | #include <QGeoPath> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| Erbt von: | QGeoShape |
Eigenschaften
Öffentliche Funktionen
| QGeoPath() | |
| QGeoPath(const QGeoShape &other) | |
| QGeoPath(const QList<QGeoCoordinate> &path, const qreal &width = 0.0) | |
| QGeoPath(const QGeoPath &other) | |
| ~QGeoPath() | |
| void | addCoordinate(const QGeoCoordinate &coordinate) |
| void | clearPath() |
| bool | containsCoordinate(const QGeoCoordinate &coordinate) const |
| QGeoCoordinate | coordinateAt(qsizetype index) const |
| void | insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate) |
| double | length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const |
| const QList<QGeoCoordinate> & | path() const |
| void | removeCoordinate(const QGeoCoordinate &coordinate) |
| void | removeCoordinate(qsizetype index) |
| void | replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate) |
| void | setPath(const QList<QGeoCoordinate> &path) |
| void | setWidth(const qreal &width) |
| qsizetype | size() const |
| QString | toString() const |
| void | translate(double degreesLatitude, double degreesLongitude) |
| QGeoPath | translated(double degreesLatitude, double degreesLongitude) const |
| qreal | width() const |
| QGeoPath & | operator=(const QGeoPath &other) |
Detaillierte Beschreibung
Der Pfad wird durch eine geordnete Liste von „ QGeoCoordinate “-Objekten definiert.
Jedes zwei benachbarte Elemente im Pfad sollen durch das kürzeste Liniensegment mit konstantem Peilwinkel verbunden werden, das durch beide Elemente verläuft. Diese Art der Verbindung kann die Datumsgrenze in Längsrichtung überqueren, kreuzt jedoch niemals die Pole.
Dies ist relevant für die Berechnung des von ` QGeoShape::boundingGeoRectangle()` für diese Form zurückgegebenen Begrenzungsrahmens, bei dem der Breitengrad der linken oberen Ecke auf den maximalen Breitengrad im Pfadpunkt-Set gesetzt wird. Analog dazu entspricht der Breitengrad der rechten unteren Ecke dem minimalen Breitengrad im Pfadpunkt-Set.
Diese Klasse ist in QML auch als ` geoPath` verfügbar.
Ein `QGeoPath` ist sowohl ungültig als auch leer, wenn er keine Koordinaten enthält.
Hinweis: Ein standardmäßig erstelltes `QGeoPath` ist sowohl ungültig als auch leer, da es keine Koordinaten enthält.
Dokumentation der Eigenschaften
path : QVariantList
Diese Eigenschaft enthält die Liste der Koordinaten für den Geopfad.
Hinweis: Die Koordinaten können nicht direkt verarbeitet werden. Um den Wert dieser Eigenschaft zu ändern, rufen Sie die vollständige Liste der Koordinaten ab, verarbeiten Sie diese und weisen Sie der Eigenschaft den neuen Wert zu.
width : qreal
Diese Eigenschaft gibt die Breite des Pfades in Metern an.
Zugriffsfunktionen:
| qreal | width() const |
| void | setWidth(const qreal &width) |
Dokumentation zu den Member-Funktionen
QGeoPath::QGeoPath()
Erstellt einen neuen, leeren Geo-Pfad.
QGeoPath::QGeoPath(const QGeoShape &other)
Erstellt einen neuen Geo-Pfad anhand des Inhalts von other.
QGeoPath::QGeoPath(const QList<QGeoCoordinate> &path, const qreal &width = 0.0)
Erstellt einen neuen Geo-Pfad aus einer Liste von Koordinaten (path und width).
QGeoPath::QGeoPath(const QGeoPath &other)
Erstellt einen neuen Geo-Pfad aus dem Inhalt von „ other “.
[noexcept] QGeoPath::~QGeoPath()
Löscht diesen Pfad.
[invokable] void QGeoPath::addCoordinate(const QGeoCoordinate &coordinate)
Fügt „ coordinate “ an den Pfad an.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
void QGeoPath::clearPath()
Macht den Weg frei.
[invokable] bool QGeoPath::containsCoordinate(const QGeoCoordinate &coordinate) const
Gibt „true“ zurück, wenn der Pfad „ coordinate “ als eines der Elemente enthält.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] QGeoCoordinate QGeoPath::coordinateAt(qsizetype index) const
Gibt die Koordinate an index zurück.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QGeoPath::insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
Fügt „ coordinate “ an der angegebenen Stelle „ index “ ein.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] double QGeoPath::length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const
Gibt die Länge des Pfades in Metern vom Element indexFrom zum Element indexTo zurück. Die Länge entspricht der Summe der kürzesten Entfernungen für jedes Paar benachbarter Punkte.
Ist indexTo gleich -1 (Standardwert), umfasst die Länge auch die Entfernung zwischen der letzten und der ersten Koordinate (geschlossener Kreis). Um die Länge des Pfades abzurufen, verwenden Sie 0 für indexFrom und QGeoPath::size() - 1 für indexTo.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
const QList<QGeoCoordinate> &QGeoPath::path() const
Gibt alle Elemente des Pfads zurück.
Siehe auch ` setPath()`.
[invokable] void QGeoPath::removeCoordinate(const QGeoCoordinate &coordinate)
Entfernt das letzte Vorkommen von „ coordinate “ aus dem Pfad.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QGeoPath::removeCoordinate(qsizetype index)
Entfernt das Element an der Position index aus dem Pfad.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QGeoPath::replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
Ersetzt das Pfadelement an der angegebenen Adresse index durch coordinate.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
void QGeoPath::setPath(const QList<QGeoCoordinate> &path)
Setzt alle Elemente des „ path “.
Siehe auch ` path()`.
[invokable] qsizetype QGeoPath::size() const
Gibt die Anzahl der Elemente im Pfad zurück.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] QString QGeoPath::toString() const
Gibt die Geo-Pfadeigenschaften als Zeichenkette zurück.
Hinweis: Diese Funktion kann über das Metaobjekt-System und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QGeoPath::translate(double degreesLatitude, double degreesLongitude)
Verschiebt diesen Geo-Pfad um degreesLatitude nach Norden und um degreesLongitude nach Osten.
Negative Werte von ` degreesLatitude ` und ` degreesLongitude ` entsprechen einer Verschiebung nach Süden bzw. nach Westen.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] QGeoPath QGeoPath::translated(double degreesLatitude, double degreesLongitude) const
Gibt eine Kopie dieses Geo-Pfads zurück, der um degreesLatitude nach Norden und um degreesLongitude nach Osten verschoben wurde.
Negative Werte von degreesLatitude und degreesLongitude entsprechen einer Verschiebung nach Süden bzw. nach Westen.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch translate().
qreal QGeoPath::width() const
Gibt die Breite des Pfades in Metern zurück. Diese Information wird in der Methode „ contains “ verwendet. Der Standardwert ist 0.
Hinweis: Getter -Funktion für die Eigenschaft „width“.
Siehe auch „ setWidth()“.
QGeoPath &QGeoPath::operator=(const QGeoPath &other)
Weist diesem Geo-Pfad „ other “ zu und gibt eine Referenz auf diesen Geo-Pfad zurück.
© 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.
