QPlaceReply Class
QPlaceReply クラスは、QPlaceManager のインスタンスによって開始された操作を管理し、より特殊な返信の基底クラスとして機能します。詳細...
| Header: | #include <QPlaceReply> |
| qmake: | QT += location |
| Inherits: | QObject |
| Inherited By: | QPlaceContentReply, QPlaceDetailsReply, QPlaceIdReply, QPlaceMatchReply, QPlaceSearchReply, and QPlaceSearchSuggestionReply |
パブリック型
| enum | Error { NoError, PlaceDoesNotExistError, CategoryDoesNotExistError, CommunicationError, ParseError, …, UnknownError } |
| enum | Type { Reply, DetailsReply, SearchReply, SearchSuggestionReply, ContentReply, …, MatchReply } |
パブリック関数
| QPlaceReply(QObject *parent = nullptr) | |
| virtual | ~QPlaceReply() |
| QPlaceReply::Error | error() const |
| QString | errorString() const |
| bool | isFinished() const |
| virtual QPlaceReply::Type | type() const |
パブリック・スロット
| virtual void | abort() |
シグナル
| void | aborted() |
| void | contentUpdated() |
| void | errorOccurred(QPlaceReply::Error error, const QString &errorString = QString()) |
| void | finished() |
プロテクトされた関数
| void | setError(QPlaceReply::Error error, const QString &errorString) |
| void | setFinished(bool finished) |
詳細な説明
QPlaceReply およびその各特殊化サブクラスは、対応する操作の状態と結果を管理します。QPlaceReply 自体は、結果のない操作、つまり操作が成功したか失敗したかを知るだけでよい操作に使用されます。
finished() シグナルを使用すると、操作の進行状況を監視できます。操作が完了すると、error() およびerrorString() メソッドが、操作が正常に完了したかどうかに関する情報を提供します。成功した場合、返信にはその操作の結果が含まれます。つまり、各サブクラスには、操作の結果を取得するための適切な関数が用意されています。
QPlaceManagerも参照してください 。
メンバ型のドキュメント
enum QPlaceReply::Error
操作中に発生したエラーについて説明します。
| 定数 | 値 | 説明 |
|---|---|---|
QPlaceReply::NoError | 0 | エラーは発生していません |
QPlaceReply::PlaceDoesNotExistError | 1 | 指定された場所が見つかりませんでした |
QPlaceReply::CategoryDoesNotExistError | 2 | 指定されたカテゴリが見つかりませんでした |
QPlaceReply::CommunicationError | 3 | サービスプロバイダーとの通信中にエラーが発生しました。 |
QPlaceReply::ParseError | 4 | サービスプロバイダーからの応答、またはインポートファイルの形式が認識できませんでした |
QPlaceReply::PermissionsError | 5 | 権限が不十分であるため、操作に失敗しました。 |
QPlaceReply::UnsupportedError | 6 | その操作はサービスプロバイダによってサポートされていませんでした。 |
QPlaceReply::BadArgumentError | 7 | 。指定されたパラメータが無効でした。 |
QPlaceReply::CancelError | 8 | 操作がキャンセルされました。 |
QPlaceReply::UnknownError | 9 | 他のどのカテゴリにも該当しないエラーが発生しました。 |
enum QPlaceReply::Type
返信のタイプを指定します。
| 定数 | 値 | 説明 |
|---|---|---|
QPlaceReply::Reply | 0 | これは汎用的な応答です。 |
QPlaceReply::DetailsReply | 1 | これは、場所の詳細を取得するための応答です。 |
QPlaceReply::SearchReply | 2 | これは、場所の検索操作に対する応答です。 |
QPlaceReply::SearchSuggestionReply | 3 | これは、検索候補操作に対する応答です。 |
QPlaceReply::ContentReply | 4 | これは、場所に関連付けられたコンテンツに対する応答です。 |
QPlaceReply::IdReply | 5 | これは、場所またはカテゴリの識別子を返す応答です。通常、場所やカテゴリの保存および削除操作に使用されます。 |
QPlaceReply::MatchReply | 6 | これは、別のプロバイダーの場所と一致する場所を返す応答です。 |
メンバー関数のドキュメント
[explicit] QPlaceReply::QPlaceReply(QObject *parent = nullptr)
指定されたparent を使用して、返信オブジェクトを作成します。
[virtual noexcept] QPlaceReply::~QPlaceReply()
reply オブジェクトを破棄します。
[virtual slot] void QPlaceReply::abort()
操作を直ちに中止します。
aborted()も参照してください 。
[signal] void QPlaceReply::aborted()
この信号は、操作がキャンセルされたときに発信されます。
abort()も参照してください 。
[signal] void QPlaceReply::contentUpdated()
このシグナルは、この応答のコンテンツが更新された際に発火します。プラグインによっては、このシグナルが一度も発火しない場合もあれば、QPlaceReply::finished() が発火する前に複数回発火する場合もあります。これは、一部のバックエンドでは、リクエストされたコンテンツを非同期かつ段階的に返すことができるためです。
注： このシグナルに接続されたスロット内で、この応答オブジェクトを `delete` または `deleteLater`しないでください 。これらは `QPlaceReply::finished` が発火した時点でのみ実行してください。
QPlaceReply::Error QPlaceReply::error() const
エラーコードを返します。
setError()も参照してください 。
[signal] void QPlaceReply::errorOccurred(QPlaceReply::Error error, const QString &errorString = QString())
このシグナルは、この応答の処理中にエラーが検出されたときに発生します。その後、finished() シグナルが発生する可能性があります。
エラーは、エラーコード `error` によって記述されます。`errorString ` が空でない場合、そこにはエンドユーザー向けではなく開発者向けのエラーに関する説明文が含まれます。
このシグナルとQPlaceManager::errorOccurred()は同時に発火します。
注： このシグナルに接続されたスロット内で、この返信オブジェクトを削除しないでください 。代わりにdeleteLater() を使用してください。
QString QPlaceReply::errorString() const
応答のエラー文字列を返します。このエラー文字列は開発者専用のものであり、エンドユーザーに表示するには適していません。
エラーが発生していない場合、文字列は空になります。
[signal] void QPlaceReply::finished()
この応答の処理が完了すると、このシグナルが発信されます。
error() の値がQPlaceReply::NoError と等しい場合、処理は正常に完了しました。
このシグナルとQPlaceManager::finished()は同時に発火します。
注： このシグナルに接続されたスロット内で、この返信オブジェクトを削除しないでください 。代わりに、deleteLater() を使用してください。
setFinished()も参照してください 。
bool QPlaceReply::isFinished() const
応答が完了した場合は true を返します。
[protected] void QPlaceReply::setError(QPlaceReply::Error error, const QString &errorString)
応答のerror およびerrorString を設定します。この関数は、QPlaceReply::errorOccurred （QPlaceReply::Error 、constQString 、およびerrorString ）シグナルを発生させません。
error()も参照してください 。
[protected] void QPlaceReply::setFinished(bool finished)
返信が「finished 」であるかどうかのステータスを設定します。この関数は、finished() シグナルを発生させません。
finished()も参照してください 。
[virtual] QPlaceReply::Type QPlaceReply::type() const
応答の型を返します。
© 2026 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.
