QGeoAreaMonitorInfo Class

成员函数文档

[explicit] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QString &name = QString())

使用指定的name 构建一个QGeoAreaMonitorInfo对象。

另请参阅 name()。

QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other)

创建一个 QGeoAreaMonitorInfo 对象，作为other 的副本。

[constexpr noexcept default, since 6.2] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(QGeoAreaMonitorInfo &&other)

通过从other 中获取数据来构建一个QGeoAreaMonitorInfo对象。

请注意，被移出的 QGeoAreaMonitorInfo 对象只能被销毁或进行赋值。调用除析构函数或赋值运算符以外的其他函数，其行为未定义。

该函数于 Qt 6.2 版本中引入。

[noexcept] QGeoAreaMonitorInfo::~QGeoAreaMonitorInfo()

析构函数

QGeoShape QGeoAreaMonitorInfo::area() const

返回待监控区域的边界。该区域不能为空。

另请参阅 setArea()。

QDateTime QGeoAreaMonitorInfo::expiration() const

返回过期日期。

当有效的QGeoAreaMonitorInfo 过期后，该区域将不再被监控，且QGeoAreaMonitorInfo 对象将从active monitors 列表中移除。

如果过期QDateTime 无效，则将QGeoAreaMonitorInfo 对象视为没有过期日期。这意味着，如果该对象是持久的，则监控期为无限期；如果该对象是非持久的，则监控期持续到当前应用程序关闭为止。

另请参阅 setExpiration() 和QGeoAreaMonitorSource::activeMonitors()。

QString QGeoAreaMonitorInfo::identifier() const

返回QGeoAreaMonitorInfo 对象的标识符。该标识符会在创建新的QGeoAreaMonitorInfo 对象时自动生成。

bool QGeoAreaMonitorInfo::isPersistent() const

如果QGeoAreaMonitorInfo 是持久性的，则返回true。该属性的默认值为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 所使用的平台特定parameters 集合。

另请参阅 notificationParameters()。

void QGeoAreaMonitorInfo::setPersistent(bool isPersistent)

将QGeoAreaMonitorInfo 对象的持久化属性设置为isPersistent 。

请注意，设置此标志并不意味着QGeoAreaMonitorSource 支持持久化监控。可使用QGeoAreaMonitorSource::supportedAreaMonitorFeatures()来检查此功能是否可用。

另请参阅 isPersistent()。

[noexcept, since 6.2] void QGeoAreaMonitorInfo::swap(QGeoAreaMonitorInfo &other)

将此QGeoAreaMonitorInfo 对象与other 进行交换。此操作速度极快，且绝不会失败。

该函数在 Qt 6.2 中引入。

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

该操作将other 移入并赋值给此QGeoAreaMonitorInfo 对象，并返回对此QGeoAreaMonitorInfo 对象的引用。

请注意，被移出的QGeoAreaMonitorInfo 只能被销毁或被赋值。调用除析构函数或赋值运算符以外的其他函数，其行为未定义。

该函数在 Qt 6.2 中引入。

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

将other 赋值给此QGeoAreaMonitorInfo 对象，并返回对此QGeoAreaMonitorInfo 对象的引用。