QGeoAreaMonitorInfo Class

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

ヘッダー #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) void swap(QGeoAreaMonitorInfo &other)
(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] void QGeoAreaMonitorInfo::swap(QGeoAreaMonitorInfo &other)

このQGeoAreaMonitorInfo オブジェクトをother と交換する。この操作は非常に高速で、失敗することはありません。

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

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

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

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

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

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

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

関連する非会員

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

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

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

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

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

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

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

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

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

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

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.