QGeoAreaMonitorInfo Class
La clase QGeoAreaMonitorInfo describe los parámetros de un área o región cuya proximidad se va a supervisar. Más información...
| Encabezado: | #include <QGeoAreaMonitorInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
- Lista de todos los miembros, incluidos los heredados
- QGeoAreaMonitorInfo forma parte de las clases compartidas implícitamente.
Funciones públicas
| 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) |
Elementos no miembros relacionados
| 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) |
Descripción detallada
El objetivo de la supervisión de áreas es informar al usuario cuando se acerca a un área de interés. En general, dicha área se describe mediante un objeto ` QGeoCircle`. El centro del círculo representa el lugar de interés y el área que lo rodea identifica la región geográfica dentro de la cual se envían las notificaciones.
Un objeto QGeoAreaMonitorInfo es válido si tiene un nombre no vacío y un area() válido. Dichos objetos deben registrarse en un QGeoAreaMonitorSource para iniciar y detener el proceso de monitorización. Tenga en cuenta que una monitorización exhaustiva puede consumir muchos recursos, ya que el motor de posicionamiento debe permanecer activo y tiene que comparar la posición actual con cada instancia de QGeoAreaMonitorInfo.
Para reducir aún más la carga sobre el sistema, existen atributos opcionales que se pueden configurar. Cada área supervisada puede tener una fecha de caducidad que elimina automáticamente dicha área de la fuente de supervisión una vez alcanzada dicha fecha. Otra opción es ajustar la persistencia de un área supervisada. Un objeto `QGeoAreaMonitorInfo` al que se le aplique ` isPersistent()` permanecerá activo más allá del ciclo de vida de la aplicación actual. Si se entra en un área mientras la aplicación de supervisión no está en ejecución, dicha aplicación se iniciará. Tenga en cuenta que esta función no está disponible en todas las plataformas. Su disponibilidad puede comprobarse mediante ` QGeoAreaMonitorSource::supportedAreaMonitorFeatures()`.
Véase también QGeoAreaMonitorSource.
Documentación de funciones miembro
[explicit] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QString &name = QString())
Crea un objeto `QGeoAreaMonitorInfo` con el ` name` especificado.
Véase también name().
QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other)
Crea un objeto `QGeoAreaMonitorInfo` como copia de un objeto ` other`.
[constexpr noexcept default, since 6.2] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(QGeoAreaMonitorInfo &&other)
Crea un objeto `QGeoAreaMonitorInfo` a partir de ` other`.
Ten en cuenta que un objeto QGeoAreaMonitorInfo obtenido mediante «moved-from» solo puede ser destruido o asignado. El efecto de llamar a otras funciones que no sean el destructor o uno de los operadores de asignación es indefinido.
Esta función se introdujo en Qt 6.2.
[noexcept] QGeoAreaMonitorInfo::~QGeoAreaMonitorInfo()
Destructor
QGeoShape QGeoAreaMonitorInfo::area() const
Devuelve los límites del área que se va a supervisar. Esta área no debe estar vacía.
Véase también setArea().
QDateTime QGeoAreaMonitorInfo::expiration() const
Devuelve la fecha de caducidad.
Una vez que ha caducado un objeto « QGeoAreaMonitorInfo » activo, la región deja de supervisarse y el objeto « QGeoAreaMonitorInfo » se elimina de la lista de « active monitors ».
Si el QDateTime de caducidad no es válido, se considera que el objeto QGeoAreaMonitorInfo no tiene fecha de caducidad. Esto implica un periodo de supervisión indefinido si el objeto es persistente, o hasta que se cierre la aplicación actual si el objeto no es persistente.
Véanse también setExpiration() y QGeoAreaMonitorSource::activeMonitors().
QString QGeoAreaMonitorInfo::identifier() const
Devuelve el identificador del objeto ` QGeoAreaMonitorInfo `. El identificador se genera automáticamente al crear un nuevo objeto ` QGeoAreaMonitorInfo `.
bool QGeoAreaMonitorInfo::isPersistent() const
Devuelve «true» si el objeto « QGeoAreaMonitorInfo » es persistente. El valor por defecto de esta propiedad es «false».
El sistema eliminará un objeto « QGeoAreaMonitorInfo » no persistente en cuanto se detenga la aplicación propietaria del objeto monitor. Los objetos persistentes permanecen activos y pueden recuperarse una vez que la aplicación se reinicie.
Si el sistema activa un evento asociado a un objeto « QGeoAreaMonitorInfo » persistente, se reiniciará la aplicación correspondiente y se emitirá la señal adecuada.
Véase también setPersistent().
bool QGeoAreaMonitorInfo::isValid() const
Devuelve «true» si el monitor es válido. Un ` QGeoAreaMonitorInfo ` válido tiene un ` name()` no vacío y el área supervisada no es ` empty()`. En caso contrario, esta función devuelve «false».
QString QGeoAreaMonitorInfo::name() const
Devuelve el nombre del objeto ` QGeoAreaMonitorInfo `. Este nombre debe utilizarse para fines de visibilidad del usuario.
Véase también setName().
QVariantMap QGeoAreaMonitorInfo::notificationParameters() const
Devuelve el conjunto de parámetros específicos de la plataforma que utiliza este QGeoAreaMonitorInfo.
Véase también setNotificationParameters().
void QGeoAreaMonitorInfo::setArea(const QGeoShape &newShape)
Establece el área que se va a supervisar en newShape.
Véase también area().
void QGeoAreaMonitorInfo::setExpiration(const QDateTime &expiry)
Establece la fecha y la hora de caducidad en expiry.
Véase también expiration().
void QGeoAreaMonitorInfo::setName(const QString &name)
Establece que el usuario pueda ver name.
Véase también name().
void QGeoAreaMonitorInfo::setNotificationParameters(const QVariantMap ¶meters)
Establece el conjunto de archivos de configuración específicos de la plataforma ( parameters ) utilizados por QGeoAreaMonitorInfo.
Véase también notificationParameters().
void QGeoAreaMonitorInfo::setPersistent(bool isPersistent)
Establece la persistencia del objeto ` QGeoAreaMonitorInfo ` en ` isPersistent`.
Ten en cuenta que establecer este indicador no implica que QGeoAreaMonitorSource admita la monitorización persistente. Se puede utilizar QGeoAreaMonitorSource::supportedAreaMonitorFeatures() para comprobar la disponibilidad de esta característica.
Véase también isPersistent().
[noexcept, since 6.2] void QGeoAreaMonitorInfo::swap(QGeoAreaMonitorInfo &other)
Intercambia este objeto ` QGeoAreaMonitorInfo ` por ` other`. Esta operación es muy rápida y nunca falla.
Esta función se introdujo en Qt 6.2.
[noexcept, since 6.2] QGeoAreaMonitorInfo &QGeoAreaMonitorInfo::operator=(QGeoAreaMonitorInfo &&other)
La operación de asignación por movimiento asigna other a este objeto QGeoAreaMonitorInfo y devuelve una referencia a este objeto QGeoAreaMonitorInfo.
Ten en cuenta que un ` QGeoAreaMonitorInfo ` del que se ha realizado una asignación por movimiento solo puede ser destruido o asignado. El efecto de llamar a otras funciones que no sean el destructor o uno de los operadores de asignación es indefinido.
Esta función se introdujo en Qt 6.2.
QGeoAreaMonitorInfo &QGeoAreaMonitorInfo::operator=(const QGeoAreaMonitorInfo &other)
Asigna ` other ` a este objeto ` QGeoAreaMonitorInfo ` y devuelve una referencia a este objeto ` QGeoAreaMonitorInfo `.
Elementos no miembros relacionados
bool operator!=(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)
Devuelve « true » si alguno de los valores del objeto « lhs » no coincide con los del objeto « rhs ». En caso contrario, devuelve « false ».
QDataStream &operator<<(QDataStream &stream, const QGeoAreaMonitorInfo &monitor)
Escribe el objeto ` monitor ` dado en el objeto ` stream` especificado.
Véase también Serialización detipos de datos de Qt.
bool operator==(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)
Devuelve « true » si todos los valores del objeto « lhs » son iguales a los del objeto « rhs ». En caso contrario, devuelve « false ».
QDataStream &operator>>(QDataStream &stream, QGeoAreaMonitorInfo &monitor)
Lee los datos de monitorización de un área desde el archivo ` stream ` especificado y los escribe en el archivo ` monitor` indicado.
Véase también «Serialización detipos de datos de 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.