Auf dieser Seite

QGeoCircle Class

Die Klasse „QGeoCircle“ definiert einen kreisförmigen geografischen Bereich. Mehr...

Header: #include <QGeoCircle>
CMake: find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake: QT += positioning
Erbt von: QGeoShape

Eigenschaften

Öffentliche Funktionen

QGeoCircle()
QGeoCircle(const QGeoShape &other)
QGeoCircle(const QGeoCoordinate &center, qreal radius = -1.0)
QGeoCircle(const QGeoCircle &other)
~QGeoCircle()
QGeoCoordinate center() const
void extendCircle(const QGeoCoordinate &coordinate)
qreal radius() const
void setCenter(const QGeoCoordinate &center)
void setRadius(qreal radius)
QString toString() const
void translate(double degreesLatitude, double degreesLongitude)
QGeoCircle translated(double degreesLatitude, double degreesLongitude) const
QGeoCircle &operator=(const QGeoCircle &other)

Ausführliche Beschreibung

Der Kreis wird durch einen „ QGeoCoordinate “ definiert, der den Mittelpunkt des Kreises angibt, sowie durch einen „qreal“, der den Radius des Kreises in Metern angibt.

Der Kreis gilt als ungültig, wenn die Koordinate des Mittelpunkts ungültig ist oder wenn der Radius kleiner als Null ist.

Diese Klasse ist in QML auch als ` geoCircle` verfügbar.

Dokumentation der Eigenschaften

center : QGeoCoordinate

Diese Eigenschaft enthält die Mittelpunktskoordinate des Geokreises.

Der Kreis gilt als ungültig, wenn diese Eigenschaft eine ungültige Koordinate enthält.

Ein standardmäßig konstruierter ` QGeoCircle ` verwendet einen ungültigen ` QGeoCoordinate ` als Mittelpunkt.

Diese Eigenschaft wurde zwar erst in Qt 5.5 eingeführt, die zugehörigen Zugriffsfunktionen sind jedoch bereits seit der ersten Version dieser Klasse vorhanden.

Zugriffsfunktionen:

QGeoCoordinate center() const
void setCenter(const QGeoCoordinate &center)

radius : qreal

Diese Eigenschaft enthält den Radius des Kreises in Metern.

Der Kreis gilt als ungültig, wenn diese Eigenschaft einen negativen Wert hat.

Standardmäßig wird der Radius mit ` -1` initialisiert.

Diese Eigenschaft wurde zwar erst in Qt 5.5 eingeführt, die zugehörigen Zugriffsfunktionen gibt es jedoch bereits seit der ersten Version dieser Klasse.

Zugriffsfunktionen:

qreal radius() const
void setRadius(qreal radius)

Dokumentation zu den Mitgliedsfunktionen

QGeoCircle::QGeoCircle()

Erstellt einen neuen, ungültigen Geokreis.

QGeoCircle::QGeoCircle(const QGeoShape &other)

Erstellt einen neuen Geo-Kreis anhand des Inhalts von „ other “.

QGeoCircle::QGeoCircle(const QGeoCoordinate &center, qreal radius = -1.0)

Erstellt einen neuen Geokreis mit dem Mittelpunkt „ center “ und einem Radius von radius Metern.

QGeoCircle::QGeoCircle(const QGeoCircle &other)

Erstellt einen neuen Geo-Kreis aus dem Inhalt von „ other “.

[noexcept] QGeoCircle::~QGeoCircle()

Löscht diesen Geokreis.

QGeoCoordinate QGeoCircle::center() const

Gibt die Koordinate des Mittelpunkts dieses Geokreises zurück. Entspricht ` QGeoShape::center()`.

Hinweis: Getter -Funktion für die Eigenschaft „center“.

Siehe auch setCenter().

[invokable] void QGeoCircle::extendCircle(const QGeoCoordinate &coordinate)

Erweitert den Geokreis so, dass er auch die Koordinate abdeckt coordinate

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

qreal QGeoCircle::radius() const

Gibt den Radius dieses Geokreises in Metern zurück.

Hinweis: Getter -Funktion für die Eigenschaft „radius“.

Siehe auch „ setRadius()“.

void QGeoCircle::setCenter(const QGeoCoordinate &center)

Setzt die Mittelpunktkoordinate dieses Geokreises auf center.

Hinweis: Setter -Funktion für die Eigenschaft ` center`.

Siehe auch „ center()“.

void QGeoCircle::setRadius(qreal radius)

Legt den Radius dieses Geokreises in Metern auf „ radius “ fest.

Hinweis: Setter -Funktion für die Eigenschaft „ radius “.

Siehe auch „ radius()“.

[invokable] QString QGeoCircle::toString() const

Gibt die Eigenschaften des Geokreises als Zeichenkette zurück.

Hinweis: Diese Funktion kann über das Metaobjekt-System und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QGeoCircle::translate(double degreesLatitude, double degreesLongitude)

Verschiebt diesen Geokreis 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] QGeoCircle QGeoCircle::translated(double degreesLatitude, double degreesLongitude) const

Gibt eine Kopie dieses Geokreises zurück, der 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().

QGeoCircle &QGeoCircle::operator=(const QGeoCircle &other)

Weist diesem Geokreis „ other “ zu und gibt eine Referenz auf diesen Geokreis 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.