Класс QGeoAreaMonitorInfo

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

Этот класс был представлен в Qt 5.2.

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

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

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

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

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

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

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

См. также QGeoAreaMonitorSource.

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

QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other)

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

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

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

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

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

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

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

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

void QGeoAreaMonitorInfo::setPersistent(bool isPersistent)

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

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

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

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

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

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

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