QGeoPolygon Class
Die Klasse „QGeoPolygon“ definiert ein geografisches Polygon. Mehr dazu...
| Header: | #include <QGeoPolygon> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| Erbt von: | QGeoShape |
Eigenschaften
- perimeter : QList<QGeoCoordinate>
Ö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) |
Ausführliche Beschreibung
Das Polygon wird durch eine geordnete Liste von „ QGeoCoordinate “-Objekten definiert, die seinen Umfang darstellen.
Jedes zwei benachbarte Elemente in dieser Liste 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 Begrenzungsrahmens, der von ` QGeoShape::boundingGeoRectangle()` für diese Form zurückgegeben wird; dabei wird der Breitengrad der oberen linken Ecke auf den maximalen Breitengrad im Pfadpunkt-Set gesetzt. Analog dazu entspricht der Breitengrad der unteren rechten Ecke dem minimalen Breitengrad im Pfadpunkt-Set.
Diese Klasse ist in QML auch als ` geoPolygon` verfügbar.
Dokumentation der Eigenschaften
perimeter : QList<QGeoCoordinate>
Diese Eigenschaft enthält die Koordinaten des Polygonumfangs.
Zugriffsfunktionen:
| const QList<QGeoCoordinate> & | perimeter() const |
| void | setPerimeter(const QList<QGeoCoordinate> &path) |
Dokumentation zu den Member-Funktionen
QGeoPolygon::QGeoPolygon()
Erstellt ein neues, leeres Geopolygon.
QGeoPolygon::QGeoPolygon(const QGeoShape &other)
Erstellt ein neues Geo-Polygon aus dem Inhalt von „ other “.
QGeoPolygon::QGeoPolygon(const QList<QGeoCoordinate> &path)
Erstellt ein neues Geopolygon aus den in „ path “ angegebenen Koordinaten.
QGeoPolygon::QGeoPolygon(const QGeoPolygon &other)
Erstellt ein neues Geopolygon aus dem Inhalt von „ other “.
[noexcept] QGeoPolygon::~QGeoPolygon()
Löscht dieses Polygon.
[invokable] void QGeoPolygon::addCoordinate(const QGeoCoordinate &coordinate)
Fügt „ coordinate “ an das Polygon an.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
void QGeoPolygon::addHole(const QList<QGeoCoordinate> &holePath)
Überladene Methode. Legt die „ holePath “ für ein Loch innerhalb des Polygons fest. Das Loch ist ein „ QList “ <QGeoCoordinate>.
[invokable] void QGeoPolygon::addHole(const QVariant &holePath)
Legt die „ holePath “ für eine Lücke innerhalb des Polygons fest. Die Lücke ist ein „ QVariant “, der ein „ QList “ <QGeoCoordinate> enthält.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe „ Q_INVOKABLE “.
[invokable] bool QGeoPolygon::containsCoordinate(const QGeoCoordinate &coordinate) const
Gibt „true“ zurück, wenn der Umfang des Polygons „ coordinate “ als eines der Elemente enthält.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] QGeoCoordinate QGeoPolygon::coordinateAt(qsizetype index) const
Gibt die Koordinate unter index zurück.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML 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 unter index darstellt.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
const QList<QGeoCoordinate> QGeoPolygon::holePath(qsizetype index) const
Gibt ein ` QList` <QGeoCoordinate> zurück, das das Loch unter index darstellt.
[invokable] qsizetype QGeoPolygon::holesCount() const
Gibt die Anzahl der Löcher zurück.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QGeoPolygon::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 QGeoPolygon::length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const
Gibt die Länge des Polygonumfangs in Metern vom Element „ indexFrom “ bis zum Element „ indexTo “ zurück. Die Länge entspricht der Summe der kürzesten Abstände zwischen jeweils zwei benachbarten Punkten.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML 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 Metaobjektsystem und aus QML 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 Metaobjektsystem und aus QML 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 Metaobjektsystem und aus QML 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 Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[since QtPositioning 5.12] void QGeoPolygon::setPerimeter(const QList<QGeoCoordinate> &path)
Legt den Umfang des Polygons anhand einer Liste von Koordinaten fest 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 im Polygon zurück.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] QString QGeoPolygon::toString() const
Gibt die Eigenschaften des Geopolygons als Zeichenkette zurück.
Hinweis: Diese Funktion kann über das Metaobjekt-System und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QGeoPolygon::translate(double degreesLatitude, double degreesLongitude)
Verschiebt dieses Geopolygon um degreesLatitude nach Norden und um degreesLongitude nach Osten.
Negative Werte für „ 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] QGeoPolygon QGeoPolygon::translated(double degreesLatitude, double degreesLongitude) const
Gibt eine Kopie dieses Geopolygons zurück, das um degreesLatitude nach Norden und um degreesLongitude nach Osten verschoben wurde.
Negative Werte für 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().
QGeoPolygon &QGeoPolygon::operator=(const QGeoPolygon &other)
Weist diesem Geopolygon die Koordinaten „ other “ zu und gibt eine Referenz auf dieses Geopolygon 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.
