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()
返信オブジェクトを破棄します。
[virtual slot] void QPlaceReply::abort()
操作を直ちにキャンセルする。
aborted()も参照 。
[signal] void QPlaceReply::aborted()
このシグナルは、操作がキャンセルされたときに発せられる。
abort()も参照のこと 。
[signal] void QPlaceReply::contentUpdated()
このシグナルは、このリプライが利用可能なコンテンツを更新したときに発行されます。バックエンドによっては、リクエストされたコンテンツを非同期でインクリメンタルに返すことができるため、プラグインによっては、このシグナルは一度も発行されないか、QPlaceReply::finished() が発行される前に複数回発行されることがあります。
注意: このシグナルに接続されたスロット内のこのリプライオブジェクトを削除したり、後で削除したりしないでください。削除するのは、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
返信のタイプを返します。
© 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.
