QGeoAreaMonitorSource Class

Documentación de las funciones de los miembros

[explicit] QGeoAreaMonitorSource::QGeoAreaMonitorSource(QObject *parent)

Crea una fuente de monitor con la dirección parent.

[virtual noexcept] QGeoAreaMonitorSource::~QGeoAreaMonitorSource()

Destruye la fuente del monitor.

[pure virtual] QList<QGeoAreaMonitorInfo> QGeoAreaMonitorSource::activeMonitors() const

Devuelve la lista de todos los monitores activos conocidos por el objeto QGeoAreaMonitorSource.

Un monitor activo se inició mediante startMonitoring(). Para cada monitor activo, el objeto fuente emitirá las señales necesarias, como areaEntered() o areaExited(). Varias instancias de QGeoAreaMonitorSource dentro de la misma aplicación comparten los mismos objetos de monitor activo.

A menos que un activo QGeoAreaMonitorInfo isPersistent () un activo QGeoAreaMonitorInfo se detendrá una vez que la aplicación actual termine.

[pure virtual] QList<QGeoAreaMonitorInfo> QGeoAreaMonitorSource::activeMonitors(const QGeoShape &lookupArea) const

Devuelve la lista de todos los monitores activos conocidos por el objeto QGeoAreaMonitorSource cuyo centro se encuentra dentro de lookupArea. Si lookupArea está vacío, la lista devuelta estará vacía.

Se ha iniciado un monitor activo a través de startMonitoring(). Para cada monitor activo, el objeto fuente emitirá las señales requeridas, como areaEntered() o areaExited(). Varias instancias de QGeoAreaMonitorSource dentro de la misma aplicación comparten los mismos objetos de monitor activo.

A menos que un activo QGeoAreaMonitorInfo isPersistent () un activo QGeoAreaMonitorInfo se detendrá una vez que la aplicación actual termine.

Véase también QGeoShape.

[signal] void QGeoAreaMonitorSource::areaEntered(const QGeoAreaMonitorInfo &monitor, const QGeoPositionInfo &update)

Se emite cuando la posición actual ha pasado de una posición fuera de la monitor activa a una posición dentro de la zona supervisada.

update mantiene la nueva posición.

[signal] void QGeoAreaMonitorSource::areaExited(const QGeoAreaMonitorInfo &monitor, const QGeoPositionInfo &update)

Se emite cuando la posición actual ha pasado de una posición dentro de la monitor activa a una posición fuera de la zona vigilada.

update mantiene la nueva posición.

[static] QStringList QGeoAreaMonitorSource::availableSources()

Devuelve una lista de los plugins de monitorización disponibles, incluyendo el backend por defecto del sistema si hay alguno disponible.

[virtual, since 6.2] QVariant QGeoAreaMonitorSource::backendProperty(const QString &name) const

Devuelve el valor de la propiedad específica del backend llamada name, si está presente. En caso contrario, el valor devuelto no será válido.

Esta función se introdujo en Qt 6.2.

Véase también setBackendProperty().

[static] QGeoAreaMonitorSource *QGeoAreaMonitorSource::createDefaultSource(QObject *parent)

Crea y devuelve una fuente de monitor con el parent dado que monitoriza áreas utilizando recursos en el sistema subyacente.

Devuelve nullptr si el sistema no admite la supervisión de posiciones.

[static] QGeoAreaMonitorSource *QGeoAreaMonitorSource::createSource(const QString &sourceName, QObject *parent)

Crea y devuelve una fuente de monitor con el nombre parent, cargando el complemento sourceName.

Devuelve nullptr si no se encuentra el complemento.

[pure virtual] QGeoAreaMonitorSource::Error QGeoAreaMonitorSource::error() const

Devuelve el tipo de error que se produjo por última vez.

[signal] void QGeoAreaMonitorSource::errorOccurred(QGeoAreaMonitorSource::Error areaMonitoringError)

Esta señal se emite tras producirse un error. El parámetro areaMonitoringError describe el tipo de error que se ha producido.

[signal] void QGeoAreaMonitorSource::monitorExpired(const QGeoAreaMonitorInfo &monitor)

Se emite cuando monitor ha caducado. Un monitor de área caducado se elimina automáticamente de la lista de activeMonitors().

Véase también activeMonitors().

[virtual] QGeoPositionInfoSource *QGeoAreaMonitorSource::positionInfoSource() const

Devuelve el QGeoPositionInfoSource actual utilizado por este objeto QGeoAreaMonitorSource. La función devolverá QGeoPositionInfoSource::createDefaultSource() si no se ha establecido ningún otro objeto.

La función devuelve nullptr si ni siquiera existe un QGeoPositionInfoSource por defecto.

Cualquier uso de la instancia QGeoPositionInfoSource devuelta debe tener en cuenta el hecho de que puede residir en un hilo diferente.

Véase también QGeoPositionInfoSource y setPositionInfoSource().

[pure virtual] bool QGeoAreaMonitorSource::requestUpdate(const QGeoAreaMonitorInfo &monitor, const char *signal)

Activa la supervisión de área de una sola vez. La monitorización de área para monitor se realizará hasta que esta instancia QGeoAreaMonitorSource emita signal por primera vez. Una vez emitida la señal, monitor se elimina automáticamente de la lista de activeMonitors(). Si monitor no es válido o tiene una fecha de caducidad superada, esta función devuelve false.

QGeoAreaMonitor singleShotMonitor;
QGeoAreaMonitorSource * source = QGeoAreaMonitorSource::createDefaultSource(this);
//...
bool ret = source->requestUpdate(singleShotMonitor,
                      SIGNAL(areaExited(QGeoAreaMonitor,QGeoPositionInfo)));

El objeto singleShotMonitor anterior dejará de enviar actualizaciones una vez que la señal areaExited() haya sido emitida por primera vez. Hasta ese momento cualquier otra señal podrá ser emitida cero o más veces dependiendo del contexto de la zona.

No es posible solicitar simultáneamente actualizaciones para más de una señal del mismo objeto monitor. La última llamada a esta función determina la señal a partir de la cual cesan las actualizaciones. En este momento sólo pueden utilizarse las señales areaEntered() y areaExited() para finalizar el proceso de monitorización.

La solicitud de monitorización persistente en una instancia de QGeoAreaMonitorSource falla si el backend de monitorización de área no admite QGeoAreaMonitorSource::PersistentAreaMonitorFeature.

Si monitor ya estaba registrado a través de startMonitoring() se convierte a un comportamiento de disparo único.

Véase también startMonitoring() y stopMonitoring().

[virtual, since 6.2] bool QGeoAreaMonitorSource::setBackendProperty(const QString &name, const QVariant &value)

Establece la propiedad específica del backend denominada name en value. Devuelve true en caso de éxito, en caso contrario devuelve false. Las propiedades específicas de backend pueden utilizarse para configurar el comportamiento del subsistema de monitorización de área en tiempo de ejecución.

Esta función se introdujo en Qt 6.2.

Véase también backendProperty().

[virtual] void QGeoAreaMonitorSource::setPositionInfoSource(QGeoPositionInfoSource *newSource)

Establece el nuevo QGeoPositionInfoSource que utilizará este objeto QGeoAreaMonitorSource. El backend de monitorización de área se convierte en el nuevo QObject padre para newSource. El objeto QGeoPositionInfoSource anterior será eliminado. Todas las instancias QGeoAreaMonitorSource basadas en el mismo sourceName() comparten la misma instancia QGeoPositionInfoSource.

Esto puede ser útil cuando se desea manipular el sistema de posicionamiento utilizado por el motor de monitorización de área.

Nótese que la propiedad debe ser cuidada por las subclases de QGeoAreaMonitorSource. Debido al patrón singleton detrás de esta clase newSource puede ser movida a un nuevo hilo.

Véase también positionInfoSource().

QString QGeoAreaMonitorSource::sourceName() const

Devuelve el nombre único de la implementación de fuente de monitor de área en uso.

Este es el mismo nombre que se puede pasar a createSource() para crear una nueva instancia de una implementación de fuente de monitor de área concreta.

[pure virtual] bool QGeoAreaMonitorSource::startMonitoring(const QGeoAreaMonitorInfo &monitor)

Devuelve true si se ha podido iniciar con éxito la monitorización de monitor; en caso contrario devuelve false. Una razón para no poder iniciar la monitorización podría ser la no disponibilidad de una fuente de información de posición por defecto apropiada mientras no se haya establecido una alternativa QGeoPositionInfoSource a través de setPositionInfoSource().

Si monitor ya está activo, el objeto monitor existente será reemplazado por la nueva referencia monitor. La identificación de las instancias de QGeoAreaMonitorInfo se realiza a través de QGeoAreaMonitorInfo::identifier(). Por lo tanto, esta función también puede utilizarse para actualizar los monitores activos.

Si monitor tiene una fecha de caducidad pasada, esta función devuelve false. La llamada a esta función para un monitor de disparo único ya registrado a través de requestUpdate() cambia el monitor a un modo de monitorización permanente.

La solicitud de monitorización permanente en una instancia de QGeoAreaMonitorSource falla si el backend de monitorización de área no soporta QGeoAreaMonitorSource::PersistentAreaMonitorFeature.

Véase también stopMonitoring().

[pure virtual] bool QGeoAreaMonitorSource::stopMonitoring(const QGeoAreaMonitorInfo &monitor)

Devuelve true si monitor fue eliminado con éxito de la lista de activeMonitors(); en caso contrario devuelve false. Este comportamiento es independiente de si monitor se registró a través de startMonitoring() o requestUpdate().

[pure virtual] QGeoAreaMonitorSource::AreaMonitorFeatures QGeoAreaMonitorSource::supportedAreaMonitorFeatures() const

Devuelve las funciones de supervisión de área disponibles para esta fuente.