Sur cette page

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. Plus d'informations...

En-tête : #include <QGeoAreaMonitorInfo>
CMake : find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake : QT += positioning

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 &parameters)
void setPersistent(bool isPersistent)
(since 6.2) void swap(QGeoAreaMonitorInfo &other)
(since 6.2) QGeoAreaMonitorInfo &operator=(QGeoAreaMonitorInfo &&other)
QGeoAreaMonitorInfo &operator=(const QGeoAreaMonitorInfo &other)
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

L'objectif de la surveillance de zone est d'informer l'utilisateur lorsqu'il s'approche d'une zone d'intérêt. En général, une telle zone est décrite par un cercle 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 à l'intérieur de laquelle les notifications sont envoyées.

Un objet QGeoAreaMonitorInfo est valide s'il a un nom non vide et un area() valide. Ces objets doivent être enregistrés auprès de QGeoAreaMonitorSource pour lancer et arrêter le processus de surveillance. Il convient de noter qu'une surveillance étendue peut être très gourmande en ressources, car le moteur de positionnement doit rester actif et doit faire correspondre la position actuelle à chaque instance de QGeoAreaMonitorInfo.

Pour réduire davantage la charge du système, il existe des attributs facultatifs qui peuvent ê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 la date d'expiration atteinte. Une autre option consiste à ajuster la persistance d'une zone surveillée. Un QGeoAreaMonitorInfo qui isPersistent() restera actif au-delà de la durée de vie de l'application actuelle. Si une zone est pénétrée alors que l'application de surveillance n'est pas en cours d'exécution, l'application 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())

Construit un objet QGeoAreaMonitorInfo avec l'adresse name spécifiée.

Voir aussi name().

QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other)

Construit un objet QGeoAreaMonitorInfo en tant que copie de other.

[constexpr noexcept, since 6.2] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(QGeoAreaMonitorInfo &&other)

Construit un objet QGeoAreaMonitorInfo en le déplaçant depuis other.

Notez qu'un QGeoAreaMonitorInfo déplacé à partir d'un autre objet 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 n'est pas dé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.

Après l'expiration d'un QGeoAreaMonitorInfo actif, la région n'est plus surveillée et l'objet QGeoAreaMonitorInfo est supprimé de la liste des active monitors.

Si la date d'expiration QDateTime 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 n'est pas persistant.

Voir également setExpiration() et QGeoAreaMonitorSource::activeMonitors().

QString QGeoAreaMonitorInfo::identifier() const

Renvoie l'identifiant de l'objet QGeoAreaMonitorInfo. L'identifiant est automatiquement généré lors de la construction d'un nouvel objet QGeoAreaMonitorInfo.

bool QGeoAreaMonitorInfo::isPersistent() const

Retourne true si le site QGeoAreaMonitorInfo est persistant. La valeur par défaut de cette propriété est false.

Un site QGeoAreaMonitorInfo non persistant sera supprimé par le système lorsque l'application propriétaire de l'objet moniteur s'arrêtera. Les objets persistants restent actifs et peuvent être récupérés lorsque l'application redémarre.

Si le système déclenche un événement associé à un objet persistant QGeoAreaMonitorInfo, l'application concernée sera redémarrée et le signal approprié sera émis.

Voir également setPersistent().

bool QGeoAreaMonitorInfo::isValid() const

Renvoie un message vrai si le moniteur est valide. Un moniteur valide QGeoAreaMonitorInfo a un name() non vide et la zone surveillée n'est pas empty(). Dans le cas contraire, cette fonction renvoie un message faux.

QString QGeoAreaMonitorInfo::name() const

Renvoie le nom de l'objet QGeoAreaMonitorInfo. Le nom doit être utilisé à des fins de visibilité pour l'utilisateur.

Voir aussi setName().

QVariantMap QGeoAreaMonitorInfo::notificationParameters() const

Renvoie l'ensemble des paramètres spécifiques à la plate-forme utilisés par cette QGeoAreaMonitorInfo.

Voir également setNotificationParameters().

void QGeoAreaMonitorInfo::setArea(const QGeoShape &newShape)

Définit la zone à surveiller sur newShape.

Voir aussi area().

void QGeoAreaMonitorInfo::setExpiration(const QDateTime &expiry)

Fixe la date et l'heure d'expiration à expiry.

Voir aussi expiration().

void QGeoAreaMonitorInfo::setName(const QString &name)

Définit la visibilité de l'utilisateur name.

Voir aussi name().

void QGeoAreaMonitorInfo::setNotificationParameters(const QVariantMap &parameters)

Définit l'ensemble de parameters spécifiques à la plate-forme et utilisés par QGeoAreaMonitorInfo.

Voir aussi notificationParameters().

void QGeoAreaMonitorInfo::setPersistent(bool isPersistent)

Définit la persistance de l'objet QGeoAreaMonitorInfo à isPersistent.

Notez que l'activation de ce drapeau n'implique pas que QGeoAreaMonitorSource prenne en charge la surveillance persistante. QGeoAreaMonitorSource::supportedAreaMonitorFeatures() peut être utilisé pour vérifier la disponibilité de cette fonctionnalité.

Voir également isPersistent().

[noexcept, since 6.2] void QGeoAreaMonitorInfo::swap(QGeoAreaMonitorInfo &other)

Remplace l'objet QGeoAreaMonitorInfo par l'objet other. Cette opération est très rapide et n'échoue jamais.

Cette fonction a été introduite dans Qt 6.2.

[noexcept, since 6.2] QGeoAreaMonitorInfo &QGeoAreaMonitorInfo::operator=(QGeoAreaMonitorInfo &&other)

Move-assigne other à cet objet QGeoAreaMonitorInfo et renvoie une référence à cet objet QGeoAreaMonitorInfo.

Notez qu'un objet QGeoAreaMonitorInfo déplacé 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 n'est pas défini.

Cette fonction a été introduite dans Qt 6.2.

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

Attribue other à l'objet QGeoAreaMonitorInfo et renvoie une référence à l'objet QGeoAreaMonitorInfo.

Non-membres apparentés

bool operator!=(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)

Renvoie true si l'une des valeurs de l'objet lhs n'est pas la même que celle de l'objet rhs. Sinon, il renvoie false.

QDataStream &operator<<(QDataStream &stream, const QGeoAreaMonitorInfo &monitor)

Écrit l'adresse monitor donnée dans l'adresse stream spécifiée.

Voir aussi Serializing Qt Data Types (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, il renvoie false.

QDataStream &operator>>(QDataStream &stream, QGeoAreaMonitorInfo &monitor)

Lit une zone de données de surveillance à partir de l'adresse stream spécifiée dans l'adresse monitor donnée.

Voir aussi Serializing Qt Data Types (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.