QGeoAreaMonitorInfo Class
La clase QGeoAreaMonitorInfo describe los parámetros de un área o región a vigilar por proximidad. Más...
| Cabecera: | #include <QGeoAreaMonitorInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning)target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
- Lista de todos los miembros, incluyendo los heredados
- QGeoAreaMonitorInfo es parte de Clases Implícitamente Compartidas.
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) |
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, un área de este tipo se describe mediante un 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. Estos objetos deben registrarse en QGeoAreaMonitorSource para iniciar y detener el proceso de supervisión. Ten en cuenta que una monitorización exhaustiva puede consumir muchos recursos, ya que el motor de posicionamiento debe permanecer activo y tiene que cotejar la posición actual con cada instancia de QGeoAreaMonitorInfo.
Para reducir aún más la carga del sistema hay atributos opcionales que se pueden establecer. Cada área monitorizada puede tener una fecha de caducidad que elimina automáticamente el área a monitorizar de la fuente de monitorización una vez alcanzada la fecha de caducidad. Otra opción es ajustar la persistencia de un área monitorizada. Un QGeoAreaMonitorInfo que isPersistent() permanecerá activo más allá del tiempo de vida de la aplicación actual. Si se entra en un área mientras la aplicación de monitorización no se está ejecutando, se iniciará la aplicación. Tenga en cuenta que esta función no está disponible en todas las plataformas. Su disponibilidad puede comprobarse a través de QGeoAreaMonitorSource::supportedAreaMonitorFeatures().
Véase también QGeoAreaMonitorSource.
Documentación de las funciones miembro
[explicit] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QString &name = QString())
Construye un objeto QGeoAreaMonitorInfo con la dirección name especificada.
Véase también name().
QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other)
Construye un objeto QGeoAreaMonitorInfo como copia de other.
[constexpr noexcept, since 6.2] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(QGeoAreaMonitorInfo &&other)
Construye un objeto QGeoAreaMonitorInfo moviendo desde other.
Ten en cuenta que un QGeoAreaMonitorInfo movido desde sólo 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 a supervisar. Esta zona no debe estar vacía.
Véase también setArea().
QDateTime QGeoAreaMonitorInfo::expiration() const
Devuelve la fecha de caducidad.
Una vez que ha expirado un QGeoAreaMonitorInfo activo, la región deja de ser supervisada y el objeto QGeoAreaMonitorInfo se elimina de la lista de active monitors.
Si la fecha de caducidad QDateTime no es válida, se considera que el objeto QGeoAreaMonitorInfo no tiene fecha de caducidad. Esto implica un periodo de monitorización indefinido si el objeto es persistente o hasta que se cierre la aplicación actual si el objeto no es persistente.
Véase también setExpiration() y QGeoAreaMonitorSource::activeMonitors().
QString QGeoAreaMonitorInfo::identifier() const
Devuelve el identificador del objeto QGeoAreaMonitorInfo. El identificador se genera automáticamente al construir un nuevo objeto QGeoAreaMonitorInfo.
bool QGeoAreaMonitorInfo::isPersistent() const
Devuelve true si QGeoAreaMonitorInfo es persistente. El valor por defecto de esta propiedad es false.
Un QGeoAreaMonitorInfo no persistente será eliminado por el sistema una vez que la aplicación propietaria del objeto monitor se detenga. Los objetos persistentes permanecen activos y pueden ser recuperados una vez que la aplicación se reinicia.
Si el sistema desencadena un evento asociado a un QGeoAreaMonitorInfo persistente, la aplicación correspondiente se reiniciará y se emitirá la señal correspondiente.
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 monitorizada no es empty(). En caso contrario, esta función devuelve false.
QString QGeoAreaMonitorInfo::name() const
Devuelve el nombre del objeto QGeoAreaMonitorInfo. El nombre debe utilizarse para que sea visible para el usuario.
Véase también setName().
QVariantMap QGeoAreaMonitorInfo::notificationParameters() const
Devuelve el conjunto de parámetros específicos de la plataforma utilizados por este QGeoAreaMonitorInfo.
Véase también setNotificationParameters().
void QGeoAreaMonitorInfo::setArea(const QGeoShape &newShape)
Establece el área a supervisar en newShape.
Véase también area().
void QGeoAreaMonitorInfo::setExpiration(const QDateTime &expiry)
Establece la fecha y hora de caducidad en expiry.
Véase también expiration().
void QGeoAreaMonitorInfo::setName(const QString &name)
Establece el usuario visibile name.
Véase también name().
void QGeoAreaMonitorInfo::setNotificationParameters(const QVariantMap ¶meters)
Establece el conjunto de plataformas específicas parameters utilizadas por QGeoAreaMonitorInfo.
Véase también notificationParameters().
void QGeoAreaMonitorInfo::setPersistent(bool isPersistent)
Establece la persistencia del objeto QGeoAreaMonitorInfo en isPersistent.
Tenga en cuenta que el establecimiento de esta bandera no implica que QGeoAreaMonitorSource soporte el seguimiento persistente. QGeoAreaMonitorSource::supportedAreaMonitorFeatures() puede utilizarse para comprobar la disponibilidad de esta función.
Véase también isPersistent().
[noexcept, since 6.2] void QGeoAreaMonitorInfo::swap(QGeoAreaMonitorInfo &other)
Intercambia este objeto QGeoAreaMonitorInfo con 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)
Mover-asigna other a este objeto QGeoAreaMonitorInfo y devuelve una referencia a este objeto QGeoAreaMonitorInfo.
Tenga en cuenta que un objeto movido desde QGeoAreaMonitorInfo sólo 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.
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 monitor dado en el stream especificado.
Véase también Serializar tipos de datos 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 del stream especificado en el monitor dado.
Véase también Serializar tipos de datos 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.
