QGeoAreaMonitorInfo Class
La classe `QGeoAreaMonitorInfo` décrit les paramètres d'une zone ou d'une région dont la proximité doit être surveillée. En savoir plus...
| En-tête : | #include <QGeoAreaMonitorInfo> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake : | QT += positioning |
- Liste de tous les membres, y compris les membres hérités
- QGeoAreaMonitorInfo fait partie des classes partagées implicitement.
Fonctions publiques
| 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) |
Éléments non membres associés
| 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) |
Description détaillée
La surveillance de zone a pour but d’informer un utilisateur lorsqu’il s’approche d’une zone d’intérêt. En général, une telle zone est décrite par un objet QGeoCircle. Le centre du cercle représente le lieu d’intérêt et la zone qui l’entoure identifie la région géographique au sein de laquelle les notifications sont envoyées.
Un objet QGeoAreaMonitorInfo est valide s’il possède un nom non vide et un area() valide. Ces objets doivent être enregistrés auprès d’un QGeoAreaMonitorSource pour démarrer et arrêter le processus de surveillance. Notez qu’une surveillance intensive peut être très gourmande en ressources, car le moteur de positionnement doit rester actif et comparer la position actuelle à chaque instance de QGeoAreaMonitorInfo.
Pour réduire davantage la charge pesant sur le système, il existe des attributs optionnels pouvant être définis. Chaque zone surveillée peut avoir une date d’expiration qui supprime automatiquement la zone à surveiller de la source de surveillance une fois cette date atteinte. Une autre option consiste à ajuster la persistance d’une zone surveillée. Une instance QGeoAreaMonitorInfo pour laquelle isPersistent() est appelé restera active au-delà de la durée de vie de l’application en cours. Si l’on pénètre dans une zone alors que l’application de surveillance n’est pas en cours d’exécution, celle-ci sera lancée. Notez que cette fonctionnalité n’est pas disponible sur toutes les plateformes. Sa disponibilité peut être vérifiée via QGeoAreaMonitorSource::supportedAreaMonitorFeatures().
Voir également QGeoAreaMonitorSource.
Documentation sur les fonctions membres
[explicit] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QString &name = QString())
Crée un objet `QGeoAreaMonitorInfo` avec les paramètres spécifiés dans ` name`.
Voir également name().
QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other)
Crée un objet `QGeoAreaMonitorInfo` qui est une copie de ` other`.
[constexpr noexcept default, since 6.2] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(QGeoAreaMonitorInfo &&other)
Construit un objet `QGeoAreaMonitorInfo` à partir d'un ` other`.
Notez qu’un objet QGeoAreaMonitorInfo obtenu par déplacement ne peut être que détruit ou assigné. L’effet de l’appel à d’autres fonctions que le destructeur ou l’un des opérateurs d’affectation est indéfini.
Cette fonction a été introduite dans Qt 6.2.
[noexcept] QGeoAreaMonitorInfo::~QGeoAreaMonitorInfo()
Destructeur
QGeoShape QGeoAreaMonitorInfo::area() const
Renvoie les limites de la zone à surveiller. Cette zone ne doit pas être vide.
Voir également setArea().
QDateTime QGeoAreaMonitorInfo::expiration() const
Renvoie la date d'expiration.
Une fois qu'une QGeoAreaMonitorInfo active a expiré, la région n'est plus surveillée et l'objet QGeoAreaMonitorInfo est supprimé de la liste des active monitors.
Si l'QDateTime d'expiration n'est pas valide, l'objet ` QGeoAreaMonitorInfo ` est considéré comme n'ayant pas de date d'expiration. Cela implique une période de surveillance indéfinie si l'objet est persistant, ou jusqu'à la fermeture de l'application en cours si l'objet est non persistant.
Voir également setExpiration() et QGeoAreaMonitorSource::activeMonitors().
QString QGeoAreaMonitorInfo::identifier() const
Renvoie l'identifiant de l'objet ` QGeoAreaMonitorInfo `. Cet identifiant est généré automatiquement lors de la création d'un nouvel objet ` QGeoAreaMonitorInfo `.
bool QGeoAreaMonitorInfo::isPersistent() const
Renvoie « true » si l'QGeoAreaMonitorInfo est persistant. La valeur par défaut de cette propriété est « false ».
Un « QGeoAreaMonitorInfo » non persistant sera supprimé par le système dès que l'application propriétaire de l'objet « monitor » s'arrêtera. Les objets persistants restent actifs et peuvent être récupérés une fois l'application redémarrée.
Si le système déclenche un événement associé à une « QGeoAreaMonitorInfo » persistante, l’application concernée sera redémarrée et le signal approprié sera émis.
Voir également setPersistent().
bool QGeoAreaMonitorInfo::isValid() const
Renvoie « true » si le moniteur est valide. Une instance de ` QGeoAreaMonitorInfo ` valide présente une méthode ` name()` non vide et la zone surveillée n'est pas ` empty()`. Dans le cas contraire, cette fonction renvoie « false ».
QString QGeoAreaMonitorInfo::name() const
Renvoie le nom de l'objet « QGeoAreaMonitorInfo ». Ce nom doit être utilisé à des fins de visibilité pour l'utilisateur.
Voir également setName().
QVariantMap QGeoAreaMonitorInfo::notificationParameters() const
Renvoie l'ensemble des paramètres spécifiques à la plate-forme utilisés par cette méthode QGeoAreaMonitorInfo.
Voir aussi setNotificationParameters().
void QGeoAreaMonitorInfo::setArea(const QGeoShape &newShape)
Définit la zone à surveiller sur newShape.
Voir également area().
void QGeoAreaMonitorInfo::setExpiration(const QDateTime &expiry)
Définit la date et l'heure d'expiration sur expiry.
Voir également expiration().
void QGeoAreaMonitorInfo::setName(const QString &name)
Définit la valeur de l'name, visible par l'utilisateur.
Voir aussi name().
void QGeoAreaMonitorInfo::setNotificationParameters(const QVariantMap ¶meters)
Définit l'ensemble des fichiers d'parameters s spécifiques à la plate-forme utilisés par QGeoAreaMonitorInfo.
Voir également notificationParameters().
void QGeoAreaMonitorInfo::setPersistent(bool isPersistent)
Définit la persistance de l'objet QGeoAreaMonitorInfo sur isPersistent.
Notez que le fait de définir cet indicateur n’implique pas que ` QGeoAreaMonitorSource ` prenne en charge la surveillance persistante. La fonction ` QGeoAreaMonitorSource::supportedAreaMonitorFeatures()` peut être utilisée pour vérifier la disponibilité de cette fonctionnalité.
Voir également isPersistent().
[noexcept, since 6.2] void QGeoAreaMonitorInfo::swap(QGeoAreaMonitorInfo &other)
Permet d'échanger cet objet ` QGeoAreaMonitorInfo ` contre ` other`. Cette opération est très rapide et ne peut jamais échouer.
Cette fonction a été introduite dans Qt 6.2.
[noexcept, since 6.2] QGeoAreaMonitorInfo &QGeoAreaMonitorInfo::operator=(QGeoAreaMonitorInfo &&other)
La fonction « move-assign » attribue other à cet objet QGeoAreaMonitorInfo et renvoie une référence à cet objet QGeoAreaMonitorInfo.
Notez qu’un objet QGeoAreaMonitorInfo ayant fait l’objet d’un déplacement ne peut être que détruit ou affecté. L’effet de l’appel à des fonctions autres que le destructeur ou l’un des opérateurs d’affectation est indéfini.
Cette fonction a été introduite dans Qt 6.2.
QGeoAreaMonitorInfo &QGeoAreaMonitorInfo::operator=(const QGeoAreaMonitorInfo &other)
Attribue ` other ` à cet objet ` QGeoAreaMonitorInfo ` et renvoie une référence à cet objet ` QGeoAreaMonitorInfo `.
Éléments non membres associés
bool operator!=(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)
Renvoie « true » si l'une des valeurs de l'objet « lhs » ne correspond pas à celles de l'objet « rhs ». Sinon, renvoie « false ».
QDataStream &operator<<(QDataStream &stream, const QGeoAreaMonitorInfo &monitor)
Écrit l'monitor on fournie dans l'stream on spécifiée.
Voir également Sérialisation des types de données Qt.
bool operator==(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)
Renvoie « true » si toutes les valeurs de l'objet ` lhs ` sont identiques à celles de l'objet ` rhs `. Sinon, renvoie « false ».
QDataStream &operator>>(QDataStream &stream, QGeoAreaMonitorInfo &monitor)
Lit les données de surveillance d'une zone à partir de l'stream spécifiée et les stocke dans l'monitor indiquée.
Voir également Sérialisation des types de données Qt.
© 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.