PySide6.QtPositioning.QGeoAreaMonitorInfo¶
- class QGeoAreaMonitorInfo¶
QGeoAreaMonitorInfo类描述了要监控接近度的区域或区域的参数。更多…概要¶
方法¶
def
__init__()def
area()def
expiration()def
identifier()def
isPersistent()def
isValid()def
name()def
__ne__()def
__eq__()def
setArea()def
setExpiration()def
setName()def
setPersistent()def
swap()
注意
本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。
详细描述¶
区域监控的目的是在用户接近感兴趣的区域时通知用户。通常，这样的区域由
QGeoCircle描述。圆的中心代表感兴趣的地点，其周围的区域标识了发送通知的地理区域。如果
QGeoAreaMonitorInfo对象具有非空名称和有效的area()，则该对象是有效的。此类对象必须注册到QGeoAreaMonitorSource以启动和停止监控过程。请注意，广泛的监控可能会非常消耗资源，因为定位引擎必须保持活动状态，并且必须将当前位置与每个QGeoAreaMonitorInfo实例进行匹配。为了进一步减轻系统负担，可以设置一些可选属性。每个监控区域可以有一个过期日期，一旦达到该日期，监控源将自动移除待监控区域。另一个选项是调整监控区域的持久性。一个
QGeoAreaMonitorInfo如果isPersistent()将在当前应用程序生命周期之外保持活动状态。如果监控应用程序未运行时进入某个区域，应用程序将启动。请注意，此功能并非在所有平台上都可用。可以通过supportedAreaMonitorFeatures()检查其可用性。- __init__(other)¶
- Parameters:
其他 –
QGeoAreaMonitorInfo
构造一个
QGeoAreaMonitorInfo对象作为other的副本。- __init__([name=""])
- Parameters:
name – str
使用指定的
name构造一个QGeoAreaMonitorInfo对象。另请参阅
返回待监控区域的边界。此区域不能为空。
另请参阅
返回到期日期。
当一个活动的
QGeoAreaMonitorInfo过期后，该区域将不再被监控，并且QGeoAreaMonitorInfo对象将从active monitors列表中移除。如果过期QDateTime无效，则
QGeoAreaMonitorInfo对象被视为没有过期日期。这意味着如果对象是持久的，则监控期限是无限的；如果对象是非持久的，则监控期限直到当前应用程序关闭。- identifier()¶
- Return type:
字符串
返回
QGeoAreaMonitorInfo对象的标识符。该标识符在构造新的QGeoAreaMonitorInfo对象时自动生成。- isPersistent()¶
- Return type:
布尔
如果
QGeoAreaMonitorInfo是持久的，则返回true。此属性的默认值为false。一个非持久的
QGeoAreaMonitorInfo将在拥有监视器对象的应用程序停止时被系统移除。持久的对象保持活动状态，并且可以在应用程序重新启动时被检索。如果系统触发了与持久性
QGeoAreaMonitorInfo相关的事件，相关应用程序将重新启动，并发出适当的信号。另请参阅
- isValid()¶
- Return type:
布尔
如果监视器有效，则返回 true。一个有效的
QGeoAreaMonitorInfo具有非空的name()并且监控区域不为empty()。否则，此函数返回 false。- name()¶
- Return type:
字符串
返回
QGeoAreaMonitorInfo对象的名称。该名称应用于用户可见的目的。另请参阅
- notificationParameters()¶
- Return type:
字典的键类型为 .QString，值类型为 QVariant。
返回此
QGeoAreaMonitorInfo使用的平台特定参数集。- __ne__(rhs)¶
- Parameters:
rhs –
QGeoAreaMonitorInfo- Return type:
布尔
如果
lhs对象的任何值与rhs对象的值不相同，则返回true。否则返回false。- __eq__(rhs)¶
- Parameters:
rhs –
QGeoAreaMonitorInfo- Return type:
布尔
如果
lhs对象的所有值与rhs对象的值相同，则返回true。否则返回false。设置要监控的区域为
newShape。另请参阅
将过期日期和时间设置为
expiry。另请参阅
- setName(name)¶
- Parameters:
name – str
设置用户可见的
name。另请参阅
- setNotificationParameters(parameters)¶
- Parameters:
parameters – 字典，键类型为 .QString，值类型为 QVariant。
设置由
QGeoAreaMonitorInfo使用的平台特定parameters集合。- setPersistent(isPersistent)¶
- Parameters:
isPersistent – 布尔值
将
QGeoAreaMonitorInfo对象的持久性设置为isPersistent。请注意，设置此标志并不意味着
QGeoAreaMonitorSource支持持久监控。可以使用supportedAreaMonitorFeatures()来检查此功能的可用性。另请参阅
- swap(other)¶
- Parameters:
其他 –
QGeoAreaMonitorInfo