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
リプライのタイプを返します。
©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 ここで提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
