Класс QGeoAreaMonitorInfo

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

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

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

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

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

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

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

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

См. также QGeoAreaMonitorSource.

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

[since 6.2] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(QGeoAreaMonitorInfo &&other)

Создает объект QGeoAreaMonitorInfo, перемещая данные из other.

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

Эта функция была добавлена в Qt 6.2.

QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other)

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

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

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

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

[since 6.2] QGeoAreaMonitorInfo &QGeoAreaMonitorInfo::operator=(QGeoAreaMonitorInfo &&other)

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

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

Эта функция была добавлена в Qt 6.2.

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 есть непустое имя 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.

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

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