Класс 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() и отслеживаемая область не является пустой(). В противном случае эта функция возвращает 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)

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

Обратите внимание, что установка этого флага не подразумевает, что 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.