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