QGeoPolygon Class
Die Klasse QGeoPolygon definiert ein geographisches Polygon. Mehr...
| Kopfzeile: | #include <QGeoPolygon> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning)target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| Vererbungen: | QGeoShape |
Öffentliche Funktionen
| QGeoPolygon() | |
| QGeoPolygon(const QGeoShape &other) | |
| QGeoPolygon(const QList<QGeoCoordinate> &path) | |
| QGeoPolygon(const QGeoPolygon &other) | |
| ~QGeoPolygon() | |
| void | addCoordinate(const QGeoCoordinate &coordinate) |
| void | addHole(const QList<QGeoCoordinate> &holePath) |
| void | addHole(const QVariant &holePath) |
| bool | containsCoordinate(const QGeoCoordinate &coordinate) const |
| QGeoCoordinate | coordinateAt(qsizetype index) const |
| const QVariantList | hole(qsizetype index) const |
| const QList<QGeoCoordinate> | holePath(qsizetype index) const |
| qsizetype | holesCount() const |
| void | insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate) |
| double | length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const |
(since QtPositioning 5.12) const QList<QGeoCoordinate> & | perimeter() const |
| void | removeCoordinate(const QGeoCoordinate &coordinate) |
| void | removeCoordinate(qsizetype index) |
| void | removeHole(qsizetype index) |
| void | replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate) |
(since QtPositioning 5.12) void | setPerimeter(const QList<QGeoCoordinate> &path) |
| qsizetype | size() const |
| QString | toString() const |
| void | translate(double degreesLatitude, double degreesLongitude) |
| QGeoPolygon | translated(double degreesLatitude, double degreesLongitude) const |
| QGeoPolygon & | operator=(const QGeoPolygon &other) |
Detaillierte Beschreibung
Das Polygon wird durch eine geordnete Liste von QGeoCoordinate Objekten definiert, die seinen Umfang darstellen.
Jeweils zwei benachbarte Elemente in dieser Liste sollen durch das kürzeste Liniensegment mit konstanter Richtung, das durch beide Elemente verläuft, miteinander verbunden werden. Diese Art der Verbindung kann die Datumslinie 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.
Dokumentation der Mitgliedsfunktionen
QGeoPolygon::QGeoPolygon()
Konstruiert ein neues, leeres Geopolygon.
QGeoPolygon::QGeoPolygon(const QGeoShape &other)
Konstruiert ein neues Geopolygon aus dem Inhalt von other.
QGeoPolygon::QGeoPolygon(const QList<QGeoCoordinate> &path)
Konstruiert ein neues Geopolygon aus den in path angegebenen Koordinaten.
QGeoPolygon::QGeoPolygon(const QGeoPolygon &other)
Konstruiert ein neues Geopolygon aus dem Inhalt von other.
[noexcept] QGeoPolygon::~QGeoPolygon()
Zerstört dieses Polygon.
[invokable] void QGeoPolygon::addCoordinate(const QGeoCoordinate &coordinate)
Hängt coordinate an das Polygon an.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
void QGeoPolygon::addHole(const QList<QGeoCoordinate> &holePath)
Überladene Methode. Setzt die holePath für ein Loch innerhalb des Polygons. Das Loch ist ein QList<QGeoCoordinate>.
[invokable] void QGeoPolygon::addHole(const QVariant &holePath)
Legt die holePath für ein Loch innerhalb des Polygons fest. Das Loch ist ein QVariant, das ein QList<QGeoCoordinate> enthält.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] bool QGeoPolygon::containsCoordinate(const QGeoCoordinate &coordinate) const
Gibt true zurück, wenn der Umriss des Polygons 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 QGeoPolygon::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] const QVariantList QGeoPolygon::hole(qsizetype index) const
Gibt ein QVariant zurück, das ein QList<QGeoCoordinate> enthält, das das Loch auf index darstellt.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
const QList<QGeoCoordinate> QGeoPolygon::holePath(qsizetype index) const
Gibt ein QList<QGeoCoordinate> zurück, das das Loch bei index darstellt.
[invokable] qsizetype QGeoPolygon::holesCount() const
Gibt die Anzahl der Löcher zurück.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QGeoPolygon::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 QGeoPolygon::length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const
Gibt die Länge des Umfangs des Polygons in Metern vom Element indexFrom bis zum Element indexTo zurück. Die Länge soll die Summe der kürzesten Entfernungen für jedes Paar benachbarter Punkte sein.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[since QtPositioning 5.12] const QList<QGeoCoordinate> &QGeoPolygon::perimeter() const
Gibt alle Elemente des Umfangs des Polygons zurück.
Hinweis: Getter-Funktion für die Eigenschaft perimeter.
Diese Funktion wurde in QtPositioning 5.12 eingeführt.
Siehe auch setPerimeter().
[invokable] void QGeoPolygon::removeCoordinate(const QGeoCoordinate &coordinate)
Entfernt das letzte Vorkommen von coordinate aus dem Polygon.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QGeoPolygon::removeCoordinate(qsizetype index)
Entfernt das Element an der Position index aus dem Polygon.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QGeoPolygon::removeHole(qsizetype index)
Entfernt das Element an der Position index aus der Liste der Löcher.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QGeoPolygon::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.
[since QtPositioning 5.12] void QGeoPolygon::setPerimeter(const QList<QGeoCoordinate> &path)
Setzt den Umfang des Polygons basierend auf einer Liste von Koordinaten path.
Hinweis: Setter-Funktion für die Eigenschaft perimeter.
Diese Funktion wurde in QtPositioning 5.12 eingeführt.
Siehe auch perimeter().
[invokable] qsizetype QGeoPolygon::size() const
Gibt die Anzahl der Elemente des Polygons zurück.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] QString QGeoPolygon::toString() const
Gibt die Eigenschaften des Geopolygons als String zurück.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QGeoPolygon::translate(double degreesLatitude, double degreesLongitude)
Verschiebt dieses Geopolygon 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] QGeoPolygon QGeoPolygon::translated(double degreesLatitude, double degreesLongitude) const
Gibt eine Kopie dieses Geopolygons 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().
QGeoPolygon &QGeoPolygon::operator=(const QGeoPolygon &other)
Weist other diesem Geopolygon zu und gibt eine Referenz auf dieses Geopolygon 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.
