QGeoAreaMonitorInfo 类

成员函数文档

[明确] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QString &name = QString())

构建一个具有指定name的QGeoAreaMonitorInfo对象。

另请参阅name。

QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other)

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

[noexcept, 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对象也将从活动监控器列表中删除。

如果过期时间 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()，且监控区域不为空。否则，该函数返回 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()。

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

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

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

移动赋值 other 到此 QGeoAreaMonitorInfo 对象，并返回对此 QGeoAreaMonitorInfo 对象的引用。

注意，移动转出 QGeoAreaMonitorInfo 后只能被销毁或赋值。调用析构函数或任何其他函数的副作用是未定义的。

此功能自Qt 6.2引入。