QGeoAreaMonitorInfo Class

QGeoAreaMonitorInfo クラスは、近接を監視するエリアまたは地域のパラメータを記述します。詳細...

Header: #include <QGeoAreaMonitorInfo>
CMake: find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake: QT += positioning

パブリック関数

QGeoAreaMonitorInfo(const QString &name = QString())
QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other)
(since 6.2) QGeoAreaMonitorInfo(QGeoAreaMonitorInfo &&other)
~QGeoAreaMonitorInfo()
QGeoShape area() const
QDateTime expiration() const
QString identifier() const
bool isPersistent() const
bool isValid() const
QString name() const
QVariantMap notificationParameters() const
void setArea(const QGeoShape &newShape)
void setExpiration(const QDateTime &expiry)
void setName(const QString &name)
void setNotificationParameters(const QVariantMap &parameters)
void setPersistent(bool isPersistent)
(since 6.2) QGeoAreaMonitorInfo &operator=(QGeoAreaMonitorInfo &&other)
QGeoAreaMonitorInfo &operator=(const QGeoAreaMonitorInfo &other)
bool operator!=(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)
QDataStream &operator<<(QDataStream &stream, const QGeoAreaMonitorInfo &monitor)
bool operator==(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)
QDataStream &operator>>(QDataStream &stream, QGeoAreaMonitorInfo &monitor)

詳細説明

エリア・モニタリングの目的は、ユーザが興味のあるエリアに近づいたときに通知することです。一般的に、このような領域はQGeoCircle で記述されます。円の中心は関心のある場所を表し、その周りの領域は通知が送信される地理的な領域を識別します。

QGeoAreaMonitorInfo オブジェクトは、空でない名前と有効なarea() を持っていれば有効である。このようなオブジェクトは、モニタリング・プロセスを開始および停止するために、QGeoAreaMonitorSource で登録する必要があります。測位エンジンはアクティブな状態を維持する必要があり、各 QGeoAreaMonitorInfo インスタンスと現在位置を一致させる必要があるため、広範なモニタリングは非常にリソースを消費することに注意してください。

システムの負担をさらに軽減するために、オプションで設定できる属性がある。各監視エリアには有効期限を設定することができ、有効期限に達すると、監視対象エリアは自動的に監視ソースから削除されます。もう一つのオプションは、監視エリアの永続性を調整することです。isPersistent() を指定した QGeoAreaMonitorInfo は、現在のアプリケーションのライフタイムを超えてもアクティブなままです。モニタリング・アプリケーションが実行されていない間にエリアに入ると、アプリケーションが起動します。この機能は、すべてのプラットフォームで利用できるわけではありません。この機能が利用可能かどうかは、QGeoAreaMonitorSource::supportedAreaMonitorFeatures() で確認できます。

QGeoAreaMonitorSourceも参照の こと。

メンバー関数ドキュメント

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

指定されたname を持つ QGeoAreaMonitorInfo オブジェクトを構築する。

name()も参照

QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other)

other のコピーとして QGeoAreaMonitorInfo オブジェクトを構築する。

[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 オブジェクトは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() ではありません。そうでない場合、この関数は偽を返します。

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] QGeoAreaMonitorInfo &QGeoAreaMonitorInfo::operator=(QGeoAreaMonitorInfo &&other)

Move-このQGeoAreaMonitorInfo オブジェクトにother を割り当て、このQGeoAreaMonitorInfo オブジェクトへの参照を返す。

移動元のQGeoAreaMonitorInfo は、破棄または代入しかできないことに注意。デストラクタや代入演算子以外の関数を呼び出した場合の効果は未定義です。

この関数は Qt 6.2 で導入されました。

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

other をこのQGeoAreaMonitorInfo オブジェクトに代入し、このQGeoAreaMonitorInfo オブジェクトへの参照を返します。

関連する非メンバー

bool operator!=(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)

lhs オブジェクトの値のいずれかがrhs オブジェクトの値と同じでない場合はtrue を返します。そうでない場合はfalse を返します。

QDataStream &operator<<(QDataStream &stream, const QGeoAreaMonitorInfo &monitor)

指定されたmonitor を指定されたstream に書き込みます。

Qt データ型のシリアライズ」も参照してください

bool operator==(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)

lhs オブジェクトの値がすべてrhs オブジェクトの値と同じ場合はtrue を返します。そうでない場合はfalse を返します。

QDataStream &operator>>(QDataStream &stream, QGeoAreaMonitorInfo &monitor)

指定されたstream から指定されたmonitor に領域監視データを読み込みます。

Qt データ型のシリアライズも参照してください

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。