QGeoPath Class
Die Klasse QGeoPath definiert einen geographischen Pfad. Mehr...
| Kopfzeile: | #include <QGeoPath> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning)target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| Vererbt: | 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.
Jeweils zwei benachbarte Elemente im Pfad sollen durch das kürzeste Liniensegment mit konstanter Peilung, das durch beide Elemente verläuft, miteinander verbunden werden. Diese Art der Verbindung kann die Datumsgrenze in Längsrichtung kreuzen, aber niemals die Pole.
Dies ist für die Berechnung des von QGeoShape::boundingGeoRectangle() zurückgegebenen Begrenzungsrahmens für diese Form von Bedeutung, bei der die Breite der oberen linken Ecke auf die maximale Breite im Pfadpunktsatz gesetzt wird. In ähnlicher Weise wird die Breite der unteren rechten Ecke auf die minimale Breite in der Pfadpunktmenge gesetzt.
Diese Klasse ist eine Q_GADGET. Sie kann direkt von C++ und QML aus verwendet werden.
Ein QGeoPath ist sowohl ungültig als auch leer, wenn er keine Koordinate enthält.
Hinweis: Ein standardmäßig konstruierter QGeoPath ist sowohl ungültig als auch leer, da er keine Koordinaten enthält.
Dokumentation der Eigenschaft
path : const QVariantList
Diese Eigenschaft enthält die Liste der Koordinaten für den Geopfad.
Hinweis: Die Koordinaten können nicht an Ort und Stelle verarbeitet werden. Um den Wert dieser Eigenschaft zu ändern, rufen Sie die vollständige Liste der Koordinaten ab, verarbeiten sie und weisen 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 der Mitgliedsfunktionen
QGeoPath::QGeoPath()
Konstruiert einen neuen, leeren Geopfad.
QGeoPath::QGeoPath(const QGeoShape &other)
Konstruiert einen neuen Geopfad aus dem Inhalt von other.
QGeoPath::QGeoPath(const QList<QGeoCoordinate> &path, const qreal &width = 0.0)
Konstruiert einen neuen Geopfad aus einer Liste von Koordinaten (path und width).
QGeoPath::QGeoPath(const QGeoPath &other)
Konstruiert einen neuen Geopfad aus dem Inhalt von other.
[noexcept] QGeoPath::~QGeoPath()
Zerstört diesen Pfad.
[invokable] void QGeoPath::addCoordinate(const QGeoCoordinate &coordinate)
Hängt coordinate an den Pfad an.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
void QGeoPath::clearPath()
Löscht den Pfad.
[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 Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] QGeoCoordinate QGeoPath::coordinateAt(qsizetype index) const
Gibt die Koordinate auf index zurück.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QGeoPath::insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
Fügt coordinate unter der angegebenen Adresse index ein.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] double QGeoPath::length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const
Gibt die Länge des Weges in Metern zurück, der vom Element indexFrom zum Element indexTo führt. Die Länge soll die Summe der kürzesten Entfernungen für jedes Paar benachbarter Punkte sein.
Wenn indexTo den Wert -1 hat (Standardwert), wird die Länge einschließlich der Entfernung zwischen der letzten und der ersten Koordinate angegeben (geschlossene Schleife). Um die Länge des Pfades zu ermitteln, verwenden Sie 0 für indexFrom und QGeoPath::size() - 1 für indexTo.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
const QList<QGeoCoordinate> &QGeoPath::path() const
Gibt alle Elemente des Pfades 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 Meta-Objektsystem und von QML aus 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 Meta-Objektsystem und von QML aus 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 Meta-Objektsystem und von QML aus 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 Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] QString QGeoPath::toString() const
Gibt die Eigenschaften des Geopfads als String zurück.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QGeoPath::translate(double degreesLatitude, double degreesLongitude)
Verschiebt diesen Geopfad um degreesLatitude nach Norden und degreesLongitude nach Osten.
Negative Werte von degreesLatitude und degreesLongitude entsprechen einer Verschiebung nach Süden bzw. nach Westen.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] QGeoPath QGeoPath::translated(double degreesLatitude, double degreesLongitude) const
Gibt eine Kopie dieses Geopfads zurück, die um degreesLatitude nach Norden und 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 Meta-Objektsystem und von QML aus 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 other diesem Geopfad zu und gibt einen Verweis auf diesen Geopfad zurück.
© 2025 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.
