Класс QGeoAreaMonitorInfo

Класс QGeoAreaMonitorInfo описывает параметры области или региона, которые должны отслеживаться на предмет близости. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Связанные нечлены

Подробное описание

Класс QGeoAreaMonitorInfo описывает параметры области или региона, которые должны отслеживаться на предмет близости.

Цель отслеживания области — информировать пользователя, когда он приближается к области интереса. В общем случае такая область описывается с помощью QGeoCircle. Центр окружности представляет собой точку интереса, а область вокруг нее определяет географический регион, в пределах которого отправляются уведомления.

Объект QGeoAreaMonitorInfo считается корректным, если у него есть непустое имя и действительная область area(). Такие объекты должны быть зарегистрированы в QGeoAreaMonitorSource, чтобы запустить и остановить процесс отслеживания. Обратите внимание, что интенсивное отслеживание может быть весьма ресурсоемким, поскольку движок определения местоположения должен оставаться активным и сопоставлять текущее положение с каждым экземпляром QGeoAreaMonitorInfo.

Для дальнейшего уменьшения нагрузки на систему можно установить дополнительные атрибуты. Каждая отслеживаемая область может иметь дату истечения срока действия, которая автоматически удаляет отслеживаемую область из источника отслеживания, как только будет достигнута дата истечения срока действия. Еще один вариант — настроить постоянство отслеживаемой области. QGeoAreaMonitorInfo, который isPersistent(), останется активным после завершения работы текущего приложения. Если область попадает в зону отслеживания, когда приложение мониторинга не запущено, приложение будет запущено. Обратите внимание, что эта функция недоступна на всех платформах. Ее доступность можно проверить с помощью QGeoAreaMonitorSource::supportedAreaMonitorFeatures().

См. также QGeoAreaMonitorSource.

Документация по членам-функциям

QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QString &name = QString())

Создает объект QGeoAreaMonitorInfo с указанным именем name.

См. также name().

QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other)

Создает объект QGeoAreaMonitorInfo как копию other.

QGeoAreaMonitorInfo::~QGeoAreaMonitorInfo()

Деструктор

QGeoShape QGeoAreaMonitorInfo::area() const

Возвращает границы отслеживаемой области. Эта область не должна быть пустой.

См. также setArea().

QDateTime QGeoAreaMonitorInfo::expiration() const

Возвращает дату истечения срока действия.

После истечения срока действия активного QGeoAreaMonitorInfo регион больше не отслеживается, а объект QGeoAreaMonitorInfo удаляется из списка активных мониторов.

Если дата истечения срока действия QDateTime недействительна, объект QGeoAreaMonitorInfo рассматривается как не имеющий даты истечения срока действия. Это означает неопределенный период мониторинга, если объект постоянный, или до закрытия текущего приложения, если объект не постоянный.

См. также setExpiration() и QGeoAreaMonitorSource::activeMonitors().

QString QGeoAreaMonitorInfo::identifier() const

Возвращает идентификатор объекта QGeoAreaMonitorInfo. Идентификатор автоматически генерируется при создании нового объекта QGeoAreaMonitorInfo.

bool QGeoAreaMonitorInfo::isPersistent() const

Возвращает true, если QGeoAreaMonitorInfo постоянный. Значение по умолчанию для этого свойства — false.

Непостоянный QGeoAreaMonitorInfo будет удален системой после того, как приложение, владеющее объектом монитора, остановится. Постоянные объекты остаются активными и могут быть получены после перезапуска приложения.

Если система вызывает событие, связанное с постоянным QGeoAreaMonitorInfo, соответствующее приложение будет перезапущено, и будет отправлено соответствующее событие.

См. также setPersistent().

bool QGeoAreaMonitorInfo::isValid() const

Возвращает true, если монитор действителен. Действительный QGeoAreaMonitorInfo имеет непустое имя name() и отслеживаемая область не пустая empty(). В противном случае эта функция возвращает false.

QString QGeoAreaMonitorInfo::name() const

Возвращает имя объекта QGeoAreaMonitorInfo. Имя должно использоваться для отображения пользователю.

См. также setName().

QVariantMap QGeoAreaMonitorInfo::notificationParameters() const

Возвращает набор параметров, специфичных для платформы, используемых этим QGeoAreaMonitorInfo.

См. также setNotificationParameters().

void QGeoAreaMonitorInfo::setArea(const QGeoShape &newShape)

Устанавливает область мониторинга на newShape.

См. также area().

void QGeoAreaMonitorInfo::setExpiration(const QDateTime &expiry)

Устанавливает срок действия до expiry.

См. также expiration().

void QGeoAreaMonitorInfo::setName(const QString &name)

Устанавливает видимое пользователю имя name.

См. также name().

void QGeoAreaMonitorInfo::setNotificationParameters(const QVariantMap &parameters)

Устанавливает набор параметров, специфичных для платформы, используемых объектом QGeoAreaMonitorInfo.

См. также notificationParameters().

void QGeoAreaMonitorInfo::setPersistent(bool isPersistent)

Устанавливает сохранение объекта QGeoAreaMonitorInfo на isPersistent.

Обратите внимание, что установка этого флага не означает, что QGeoAreaMonitorInfoSource поддерживает сохранение мониторинга. Для проверки доступности этой функции можно использовать QGeoAreaMonitorSource::supportedAreaMonitorFeatures().

См. также isPersistent().

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

Возвращает true, если какие-либо значения этого объекта не совпадают со значениями other.

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

Присваивает other этому объекту QGeoAreaMonitorInfo и возвращает ссылку на этот объект QGeoAreaMonitorInfo.

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

Возвращает true, если все значения этого объекта совпадают со значениями other.