QGeoCodeReply Class
QGeoCodeReply クラスは、QGeoCodingManager のインスタンスによって開始された操作を管理する。
| Header: | #include <QGeoCodeReply> |
| qmake: | QT += location |
| Inherits: | QObject |
パブリック型
| enum | Error { NoError, EngineNotSetError, CommunicationError, ParseError, UnsupportedOptionError, …, UnknownError } |
パブリック関数
| QGeoCodeReply(QGeoCodeReply::Error error, const QString &errorString, QObject *parent = nullptr) | |
| virtual | ~QGeoCodeReply() |
| virtual void | abort() |
| QGeoCodeReply::Error | error() const |
| QString | errorString() const |
| bool | isFinished() const |
| qsizetype | limit() const |
| QList<QGeoLocation> | locations() const |
| qsizetype | offset() const |
| QGeoShape | viewport() const |
シグナル
| void | aborted() |
| void | errorOccurred(QGeoCodeReply::Error error, const QString &errorString = QString()) |
| void | finished() |
保護された関数
| QGeoCodeReply(QObject *parent = nullptr) | |
| void | addLocation(const QGeoLocation &location) |
| void | setError(QGeoCodeReply::Error error, const QString &errorString) |
| void | setFinished(bool finished) |
| void | setLimit(qsizetype limit) |
| void | setLocations(const QList<QGeoLocation> &locations) |
| void | setOffset(qsizetype offset) |
| void | setViewport(const QGeoShape &viewport) |
詳細説明
QGeoCodeReply のインスタンスは、これらの操作の状態と結果を管理する。
isFinished （）、error （）、errorString （）メソッドは、操作が完了したかどうか、正常に完了したかどうかの情報を提供します。
finished() およびerrorOccurred(QGeoCodeReply::Error,QString) シグナルを使用して、操作の進行状況を監視することができる。
新しく作成された QGeoCodeReply が終了状態になっている可能性があります。このようなインスタンスがfinished() やerrorOccurred(QGeoCodeReply::Error,QString) シグナルを発することはないため、シグナルへの接続を行う前にisFinished() の結果を確認することが重要です。QGeoCodingManager のドキュメントに、その方法が示されている。
操作が正常に完了すると、locations() で結果にアクセスできるようになる。
メンバ型のドキュメント
enum QGeoCodeReply::Error
操作の完了を妨げたエラーについて説明する。
| 定数 | 値 | 説明 |
|---|---|---|
QGeoCodeReply::NoError | 0 | エラーは発生しませんでした。 |
QGeoCodeReply::EngineNotSetError | 1 | 使用されたジオコーディング・マネージャには、QGeoCodingManagerEngine インスタンスが関連付けられていませんでした。 |
QGeoCodeReply::CommunicationError | 2 | サービスプロバイダとの通信中にエラーが発生しました。 |
QGeoCodeReply::ParseError | 3 | サービスプロバイダからの応答が認識できない形式であった。 |
QGeoCodeReply::UnsupportedOptionError | 4 | 要求された操作または操作のオプションの1つが、サービスプロバイダによってサポートされていません。 |
QGeoCodeReply::CombinationError | 5 | 複数のソースからの結果を組み合わせているときにエラーが発生した。 |
QGeoCodeReply::UnknownError | 6 | 他のどのカテゴリーにも当てはまらないエラーが発生した。 |
メンバ関数ドキュメント
[explicit protected] QGeoCodeReply::QGeoCodeReply(QObject *parent = nullptr)
指定されたparent でジオコード応答を構築する。
[explicit] QGeoCodeReply::QGeoCodeReply(QGeoCodeReply::Error error, const QString &errorString, QObject *parent = nullptr)
指定されたerror およびerrorString と指定されたparent でジオコード応答を構築する。
[virtual noexcept] QGeoCodeReply::~QGeoCodeReply()
この応答オブジェクトを破棄します。
[virtual] void QGeoCodeReply::abort()
操作を直ちにキャンセルします。
返信が終了した場合は何もしません。
aborted()も参照してください 。
[signal] void QGeoCodeReply::aborted()
このシグナルは、操作がキャンセルされたときに発せられます。
abort() も参照して ください。
[protected] void QGeoCodeReply::addLocation(const QGeoLocation &location)
このリプライのロケーションのリストにlocation を追加する。
QGeoCodeReply::Error QGeoCodeReply::error() const
このリプライのエラー状態を返す。
結果がQGeoCodeReply::NoError の場合、エラーは発生していない。
setError()も参照 。
[signal] void QGeoCodeReply::errorOccurred(QGeoCodeReply::Error error, const QString &errorString = QString())
このシグナルは、このリプライの処理でエラーが検出されたときに発行されます。おそらくfinished() シグナルに続く。
エラーは、エラーコードerror で示される。errorString が空でない場合、エラーのテキスト記述が含まれる。
このシグナルとQGeoCodingManager::errorOccurred() は同時に発せられる。
注意： このシグナルに接続されたスロット内のこの応答オブジェクトを削除しないでください。代わりにdeleteLater() を使用してください。
QString QGeoCodeReply::errorString() const
このリプライのエラー状態のテキスト表現を返します。
エラーが発生していない場合は、空の文字列を返します。関連するテキスト表現がないエラーが発生した可能性もあり、その場合はこれも空文字列を返します。
エラーが発生したかどうかを判断するには、QGeoCodeReply::error() がQGeoCodeReply::NoError と等しいかどうかを確認する。
[signal] void QGeoCodeReply::finished()
このシグナルは、この応答が処理を終了したときに発せられる。
error() がQGeoCodeReply::NoError と等しい場合、処理は正常に終了している。
このシグナルとQGeoCodingManager::finished() は同時に発せられる。
注意: このシグナルに接続されているスロットで、この返信オブジェクトを削除しないでください。代わりにdeleteLater() を使用してください。
setFinished()も参照 。
bool QGeoCodeReply::isFinished() const
操作が正常に完了した場合、または操作が停止するようなエラーが発生した場合に true を返します。
qsizetype QGeoCodeReply::limit() const
各データ・ソースからの応答数の制限を返します。
制限が設定されていない場合、この関数は -1 を返します。
応答数が要求された数より少ない場合は、locations().length() より多くなることがあります。
setLimit()も参照してください 。
QList<QGeoLocation> QGeoCodeReply::locations() const
位置のリストを返す。
場所は、この応答を作成したQGeoCodingManager 関数に対応する操作の結果である。
setLocations()も参照 。
qsizetype QGeoCodeReply::offset() const
結果のフェッチを開始する、結果セット全体のオフセットを返します。
setOffset() も参照して ください。
[protected] void QGeoCodeReply::setError(QGeoCodeReply::Error error, const QString &errorString)
この応答のエラー状態をerror に設定し、エラーのテキスト表現をerrorString に設定します。
これはまた、errorOccurred() とfinished() のシグナルを、この順番で発生させる。
error()も参照 。
[protected] void QGeoCodeReply::setFinished(bool finished)
この応答が終了したかどうかをfinished に設定する。
finished がtrueの場合、finished() シグナルが発行される。
操作が正常に完了した場合は、この関数の前にQGeoCodeReply::setLocations() を呼び出す。エラーが発生した場合は、代わりにQGeoCodeReply::setError() を使用する。
finished()も参照 。
[protected] void QGeoCodeReply::setLimit(qsizetype limit)
各データ・ソースからの応答数の上限をlimit に設定します。
limit が -1 の場合は、使用可能なすべての応答が返されます。
limit() も参照して ください。
[protected] void QGeoCodeReply::setLocations(const QList<QGeoLocation> &locations)
応答のlocations のリストを設定します。
locations() も参照して ください。
[protected] void QGeoCodeReply::setOffset(qsizetype offset)
結果のフェッチを開始する結果セット全体のオフセットをoffset に設定します。
offset() も参照して ください。
[protected] void QGeoCodeReply::setViewport(const QGeoShape &viewport)
結果を含むビューポートをviewport に設定します。
viewport() も参照 。
QGeoShape QGeoCodeReply::viewport() const
結果を含むビューポートを返します。
この応答を作成したQGeoCodingManager 関数でビューポート・バイアスが指定されていない場合、この関数はnullptr を返します。
setViewport()も参照して ください。
©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
