QGeoAreaMonitorInfo Class
Die Klasse „QGeoAreaMonitorInfo“ beschreibt die Parameter eines Bereichs oder einer Region, die auf Annäherung überwacht werden sollen. Mehr...
| Header: | #include <QGeoAreaMonitorInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QGeoAreaMonitorInfo gehört zu den implizit gemeinsam genutzten Klassen.
Öffentliche Funktionen
| QGeoAreaMonitorInfo(const QString &name = QString()) | |
| QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other) | |
(since 6.2) | QGeoAreaMonitorInfo(QGeoAreaMonitorInfo &&other) |
| ~QGeoAreaMonitorInfo() | |
| QGeoShape | area() const |
| QDateTime | expiration() const |
| QString | identifier() const |
| bool | isPersistent() const |
| bool | isValid() const |
| QString | name() const |
| QVariantMap | notificationParameters() const |
| void | setArea(const QGeoShape &newShape) |
| void | setExpiration(const QDateTime &expiry) |
| void | setName(const QString &name) |
| void | setNotificationParameters(const QVariantMap ¶meters) |
| void | setPersistent(bool isPersistent) |
(since 6.2) void | swap(QGeoAreaMonitorInfo &other) |
(since 6.2) QGeoAreaMonitorInfo & | operator=(QGeoAreaMonitorInfo &&other) |
| QGeoAreaMonitorInfo & | operator=(const QGeoAreaMonitorInfo &other) |
Verwandte Nicht-Mitglieder
| bool | operator!=(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs) |
| QDataStream & | operator<<(QDataStream &stream, const QGeoAreaMonitorInfo &monitor) |
| bool | operator==(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QGeoAreaMonitorInfo &monitor) |
Detaillierte Beschreibung
Der Zweck der Bereichsüberwachung besteht darin, einen Benutzer zu informieren, wenn er sich einem Bereich von Interesse nähert. Im Allgemeinen wird ein solcher Bereich durch einen „ QGeoCircle “ beschrieben. Der Mittelpunkt des Kreises stellt den Ort von Interesse dar, und der Bereich um ihn herum definiert die geografische Region, innerhalb derer Benachrichtigungen gesendet werden.
Ein QGeoAreaMonitorInfo-Objekt ist gültig, wenn es einen nicht leeren Namen und ein gültiges area() aufweist. Solche Objekte müssen bei einem QGeoAreaMonitorSource registriert werden, um den Überwachungsprozess zu starten und zu beenden. Beachten Sie, dass eine umfassende Überwachung sehr ressourcenintensiv sein kann, da die Positionsbestimmungs-Engine aktiv bleiben muss und die aktuelle Position mit jeder QGeoAreaMonitorInfo-Instanz abgleichen muss.
Um die Belastung des Systems weiter zu reduzieren, gibt es optionale Attribute, die gesetzt werden können. Jeder überwachte Bereich kann ein Ablaufdatum haben, wodurch der zu überwachende Bereich automatisch aus der Überwachungsquelle entfernt wird, sobald das Ablaufdatum erreicht ist. Eine weitere Option ist die Anpassung der Persistenz eines überwachten Bereichs. Ein `QGeoAreaMonitorInfo`-Objekt, für das ` isPersistent()` aufgerufen wurde, bleibt über die Lebensdauer der aktuellen Anwendung hinaus aktiv. Wird ein Bereich betreten, während die Überwachungsanwendung nicht läuft, wird die Anwendung gestartet. Beachten Sie, dass diese Funktion nicht auf allen Plattformen verfügbar ist. Ihre Verfügbarkeit kann über ` QGeoAreaMonitorSource::supportedAreaMonitorFeatures()` überprüft werden.
Siehe auch QGeoAreaMonitorSource.
Dokumentation der Mitgliedsfunktionen
[explicit] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QString &name = QString())
Erstellt ein `QGeoAreaMonitorInfo`-Objekt mit dem angegebenen ` name`.
Siehe auch name().
QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other)
Erstellt ein `QGeoAreaMonitorInfo`-Objekt als Kopie von ` other`.
[constexpr noexcept default, since 6.2] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(QGeoAreaMonitorInfo &&other)
Erstellt ein `QGeoAreaMonitorInfo`-Objekt durch Verschieben von ` other`.
Beachten Sie, dass ein aus einer anderen Instanz übertragene `QGeoAreaMonitorInfo` nur zerstört oder einer Variablen zugewiesen werden kann. Die Auswirkungen des Aufrufs anderer Funktionen als des Destruktors oder eines der Zuweisungsoperatoren sind undefiniert.
Diese Funktion wurde in Qt 6.2 eingeführt.
[noexcept] QGeoAreaMonitorInfo::~QGeoAreaMonitorInfo()
Destruktor
QGeoShape QGeoAreaMonitorInfo::area() const
Gibt die Grenzen des zu überwachenden Bereichs zurück. Dieser Bereich darf nicht leer sein.
Siehe auch „ setArea()“.
QDateTime QGeoAreaMonitorInfo::expiration() const
Gibt das Ablaufdatum zurück.
Nach Ablauf eines aktiven „ QGeoAreaMonitorInfo “ wird die Region nicht mehr überwacht und das „ QGeoAreaMonitorInfo “-Objekt wird aus der Liste „ active monitors “ entfernt.
Ist der Ablauf QDateTime ungültig, wird das Objekt „ QGeoAreaMonitorInfo “ so behandelt, als hätte es kein Ablaufdatum. Dies bedeutet eine unbefristete Überwachungsdauer, wenn das Objekt persistent ist, oder eine Überwachung bis zum Beenden der aktuellen Anwendung, wenn das Objekt nicht-persistent ist.
Siehe auch ` setExpiration()` und ` QGeoAreaMonitorSource::activeMonitors()`.
QString QGeoAreaMonitorInfo::identifier() const
Gibt die Kennung des Objekts „ QGeoAreaMonitorInfo “ zurück. Die Kennung wird beim Anlegen eines neuen Objekts „ QGeoAreaMonitorInfo “ automatisch generiert.
bool QGeoAreaMonitorInfo::isPersistent() const
Gibt „true“ zurück, wenn das „ QGeoAreaMonitorInfo “ persistent ist. Der Standardwert dieser Eigenschaft ist „false“.
Ein nicht persistentes „ QGeoAreaMonitorInfo “ wird vom System entfernt, sobald die Anwendung, der das Monitorobjekt gehört, beendet wird. Persistente Objekte bleiben aktiv und können nach dem Neustart der Anwendung wieder abgerufen werden.
Wenn das System ein Ereignis auslöst, das mit einem persistenten „ QGeoAreaMonitorInfo “ verknüpft ist, wird die entsprechende Anwendung neu gestartet und das entsprechende Signal ausgegeben.
Siehe auch ` setPersistent()`.
bool QGeoAreaMonitorInfo::isValid() const
Gibt „true“ zurück, wenn der Monitor gültig ist. Ein gültiges „ QGeoAreaMonitorInfo “ weist eine nicht leere „ name()“-Methode auf, und der überwachte Bereich ist nicht „ empty()“. Andernfalls gibt diese Funktion „false“ zurück.
QString QGeoAreaMonitorInfo::name() const
Gibt den Namen des Objekts „ QGeoAreaMonitorInfo “ zurück. Der Name sollte zur Anzeige für den Benutzer verwendet werden.
Siehe auch setName().
QVariantMap QGeoAreaMonitorInfo::notificationParameters() const
Gibt die Menge der plattformspezifischen Parameter zurück, die von dieser Funktion „ QGeoAreaMonitorInfo “ verwendet werden.
Siehe auch setNotificationParameters().
void QGeoAreaMonitorInfo::setArea(const QGeoShape &newShape)
Legt den zu überwachenden Bereich auf „ newShape “ fest.
Siehe auch area().
void QGeoAreaMonitorInfo::setExpiration(const QDateTime &expiry)
Legt das Ablaufdatum und die Ablaufzeit auf „ expiry “ fest.
Siehe auch expiration().
void QGeoAreaMonitorInfo::setName(const QString &name)
Legt fest, ob „ name “ für den Benutzer sichtbar ist.
Siehe auch name().
void QGeoAreaMonitorInfo::setNotificationParameters(const QVariantMap ¶meters)
Legt die plattformspezifischen „ parameters “ fest, die von „ QGeoAreaMonitorInfo “ verwendet werden.
Siehe auch ` notificationParameters()`.
void QGeoAreaMonitorInfo::setPersistent(bool isPersistent)
Legt die Persistenz des QGeoAreaMonitorInfo -Objekts auf „ isPersistent “ fest.
Beachten Sie, dass das Setzen dieses Flags nicht bedeutet, dass „ QGeoAreaMonitorSource “ eine persistente Überwachung unterstützt. Mit „ QGeoAreaMonitorSource::supportedAreaMonitorFeatures()“ kann überprüft werden, ob diese Funktion verfügbar ist.
Siehe auch ` isPersistent()`.
[noexcept, since 6.2] void QGeoAreaMonitorInfo::swap(QGeoAreaMonitorInfo &other)
Tauscht dieses QGeoAreaMonitorInfo -Objekt gegen other aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.
Diese Funktion wurde in Qt 6.2 eingeführt.
[noexcept, since 6.2] QGeoAreaMonitorInfo &QGeoAreaMonitorInfo::operator=(QGeoAreaMonitorInfo &&other)
Die Move-Zuweisung weist other diesem QGeoAreaMonitorInfo -Objekt zu und gibt eine Referenz auf dieses QGeoAreaMonitorInfo -Objekt zurück.
Beachten Sie, dass ein verschobenes ` QGeoAreaMonitorInfo ` nur zerstört oder neu zugewiesen werden kann. Die Auswirkungen des Aufrufs anderer Funktionen als des Destruktors oder eines der Zuweisungsoperatoren sind undefiniert.
Diese Funktion wurde in Qt 6.2 eingeführt.
QGeoAreaMonitorInfo &QGeoAreaMonitorInfo::operator=(const QGeoAreaMonitorInfo &other)
Weist diesem QGeoAreaMonitorInfo -Objekt den Wert „ other “ zu und gibt eine Referenz auf dieses QGeoAreaMonitorInfo -Objekt zurück.
Verwandte Nicht-Mitglieder
bool operator!=(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)
Gibt „ true “ zurück, wenn einer der Werte des Objekts „ lhs “ nicht mit denen des Objekts „ rhs “ übereinstimmt. Andernfalls wird „ false “ zurückgegeben.
QDataStream &operator<<(QDataStream &stream, const QGeoAreaMonitorInfo &monitor)
Schreibt die angegebene ` monitor ` in die angegebene ` stream`.
Siehe auch „Serialisierung vonQt-Datentypen“.
bool operator==(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)
Gibt „ true “ zurück, wenn alle Werte des Objekts „ lhs “ mit denen des Objekts „ rhs “ übereinstimmen. Andernfalls wird „ false “ zurückgegeben.
QDataStream &operator>>(QDataStream &stream, QGeoAreaMonitorInfo &monitor)
Liest Bereichsüberwachungsdaten aus dem angegebenen „ stream “ in die angegebene „ monitor “ ein.
Siehe auch „Serialisierung vonQt-Datentypen“.
© 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.