QGeoAreaMonitorInfo Class
Die Klasse QGeoAreaMonitorInfo beschreibt die Parameter eines Gebiets oder einer Region, die auf Nähe überwacht werden soll. Mehr...
Kopfzeile: | #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 ist Teil von Implicitly Shared Classes.
Ö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) |
Zugehörige Nicht-Members
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 Gebietsüberwachung besteht darin, einen Benutzer zu informieren, wenn er sich einem Gebiet von Interesse nähert. Im Allgemeinen wird ein solches Gebiet durch einen QGeoCircle beschrieben. Der Mittelpunkt des Kreises stellt den Ort von Interesse dar und der Bereich um ihn herum identifiziert 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() hat. Solche Objekte müssen mit einer QGeoAreaMonitorSource registriert werden, um den Überwachungsprozess zu starten und zu stoppen. Beachten Sie, dass eine umfangreiche Überwachung sehr ressourcenintensiv sein kann, da die Positionierungsmaschine 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. Jedes überwachte Gebiet kann mit einem Ablaufdatum versehen werden, wodurch das zu überwachende Gebiet automatisch aus der Überwachungsquelle entfernt wird, sobald das Ablaufdatum erreicht ist. Eine weitere Option ist die Einstellung der Persistenz eines Überwachungsgebietes. Eine QGeoAreaMonitorInfo, die isPersistent() enthält, bleibt über die Lebensdauer der aktuellen Anwendung hinaus aktiv. Wenn ein Gebiet betreten wird, 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())
Konstruiert ein QGeoAreaMonitorInfo-Objekt mit dem angegebenen name.
Siehe auch name().
QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other)
Konstruiert ein QGeoAreaMonitorInfo-Objekt als Kopie von other.
[noexcept, since 6.2]
QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(QGeoAreaMonitorInfo &&other)
Konstruiert ein QGeoAreaMonitorInfo-Objekt durch Verschieben von other.
Beachten Sie, dass ein verschobenes QGeoAreaMonitorInfo nur zerstört oder zugewiesen werden kann. Der Effekt des Aufrufs anderer Funktionen als des Destruktors oder eines der Zuweisungsoperatoren ist undefiniert.
Diese Funktion wurde in Qt 6.2 eingeführt.
[noexcept]
QGeoAreaMonitorInfo::~QGeoAreaMonitorInfo()
Zerstörer
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 Verfallsdatum zurück.
Nachdem ein aktives QGeoAreaMonitorInfo abgelaufen ist, wird die Region nicht mehr überwacht und das QGeoAreaMonitorInfo Objekt wird aus der Liste active monitors entfernt.
Wenn das Ablaufdatum QDateTime ungültig ist, wird das Objekt QGeoAreaMonitorInfo so behandelt, als hätte es kein Ablaufdatum. Dies impliziert eine unbegrenzte Überwachungszeit, wenn das Objekt persistent ist, oder bis zum Ende der aktuellen Anwendung, wenn das Objekt nicht persistent ist.
Siehe auch setExpiration() und QGeoAreaMonitorSource::activeMonitors().
QString QGeoAreaMonitorInfo::identifier() const
Gibt den Bezeichner des QGeoAreaMonitorInfo Objekts zurück. Der Bezeichner wird automatisch bei der Erstellung eines neuen QGeoAreaMonitorInfo Objekts generiert.
bool QGeoAreaMonitorInfo::isPersistent() const
Gibt true zurück, wenn die QGeoAreaMonitorInfo dauerhaft ist. Der Standardwert für diese Eigenschaft ist false.
Ein nicht persistentes QGeoAreaMonitorInfo wird vom System entfernt, sobald die Anwendung, die das Monitorobjekt besitzt, beendet wird. Persistente Objekte bleiben aktiv und können nach dem Neustart der Anwendung abgerufen werden.
Wenn das System ein Ereignis auslöst, das mit einem persistenten QGeoAreaMonitorInfo verbunden 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 hat einen nicht leeren name() und der überwachte Bereich ist nicht empty(). Andernfalls gibt diese Funktion false zurück.
QString QGeoAreaMonitorInfo::name() const
Gibt den Namen des QGeoAreaMonitorInfo Objekts zurück. Der Name sollte für die Sichtbarkeit für den Benutzer verwendet werden.
Siehe auch setName().
QVariantMap QGeoAreaMonitorInfo::notificationParameters() const
Gibt die Menge der plattformspezifischen Parameter zurück, die von diesem QGeoAreaMonitorInfo verwendet werden.
Siehe auch setNotificationParameters().
void QGeoAreaMonitorInfo::setArea(const QGeoShape &newShape)
Setzt den zu überwachenden Bereich auf newShape.
Siehe auch area().
void QGeoAreaMonitorInfo::setExpiration(const QDateTime &expiry)
Setzt das Verfallsdatum und die Uhrzeit auf expiry.
Siehe auch expiration().
void QGeoAreaMonitorInfo::setName(const QString &name)
Legt die Sichtbarkeit des Benutzers name fest.
Siehe auch name().
void QGeoAreaMonitorInfo::setNotificationParameters(const QVariantMap ¶meters)
Legt den Satz der plattformspezifischen parameters fest, der von QGeoAreaMonitorInfo verwendet wird.
Siehe auch notificationParameters().
void QGeoAreaMonitorInfo::setPersistent(bool isPersistent)
Setzt die Persistenz des Objekts QGeoAreaMonitorInfo auf isPersistent.
Beachten Sie, dass das Setzen dieses Flags nicht bedeutet, dass QGeoAreaMonitorSource persistente Überwachung unterstützt. QGeoAreaMonitorSource::supportedAreaMonitorFeatures() kann verwendet werden, um die Verfügbarkeit dieser Funktion zu prüfen.
Siehe auch isPersistent().
[noexcept, since 6.2]
void QGeoAreaMonitorInfo::swap(QGeoAreaMonitorInfo &other)
Tauscht dieses QGeoAreaMonitorInfo Objekt mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.
Diese Funktion wurde in Qt 6.2 eingeführt.
[noexcept, since 6.2]
QGeoAreaMonitorInfo &QGeoAreaMonitorInfo::operator=(QGeoAreaMonitorInfo &&other)
Move weist other diesem QGeoAreaMonitorInfo Objekt zu und gibt einen Verweis auf dieses QGeoAreaMonitorInfo Objekt zurück.
Beachten Sie, dass ein von QGeoAreaMonitorInfo verschobenes Objekt nur zerstört oder zugewiesen werden kann. Der Effekt des Aufrufs anderer Funktionen als des Destruktors oder eines der Zuweisungsoperatoren ist undefiniert.
Diese Funktion wurde in Qt 6.2 eingeführt.
QGeoAreaMonitorInfo &QGeoAreaMonitorInfo::operator=(const QGeoAreaMonitorInfo &other)
Weist other diesem QGeoAreaMonitorInfo Objekt zu und gibt einen Verweis 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 von Qt-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 einen Bereich Überwachungsdaten aus dem angegebenen stream in den angegebenen monitor.
Siehe auch Serialisierung von Qt-Datentypen.
© 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.