QQuickImageResponse Class
QQuickImageResponse クラスは、QQuickAsyncImageProvider における非同期画像読み込みのためのインターフェースを提供します。詳細...
| ヘッダー: | #include <QQuickImageResponse> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| 継承元: | QObject |
パブリック関数
| QQuickImageResponse() | |
| virtual | ~QQuickImageResponse() override |
| virtual QString | errorString() const |
| virtual QQuickTextureFactory * | textureFactory() const = 0 |
パブリックスロット
| virtual void | cancel() |
シグナル
| void | finished() |
詳細な説明
イメージ・レスポンスの目的は、イメージ・プロバイダ・ジョブを非同期的に実行する手段を提供することです。
finished() シグナルが発行されると、deleteLater によってレスポンスは削除されます。QQuickImageResponse のベースとしてQRunnable を使用している場合は、自動削除が無効になっていることを確認してください。
完全な実装については、「Image Response Provider Example」を参照してください。
QQuickImageProviderも参照してください 。
メンバ関数のドキュメント
QQuickImageResponse::QQuickImageResponse()
画像レスポンスを生成します
[override virtual noexcept] QQuickImageResponse::~QQuickImageResponse()
画像レスポンスを破棄します
[virtual slot] void QQuickImageResponse::cancel()
このメソッドは、エンジンがレスポンスを必要としなくなったことを通知するために使用されます。
プロバイダ側でリクエストをキャンセルするために再実装することもできますが、必須ではありません。
キャンセルされた `QQuickImageResponse ` は、エンジンが `QQuickImageResponse` をクリーンアップできるように、finished() を発行する必要があります。
注: ` finished()` は 、`cancel()` が呼び出されたかどうかに関わらず、レスポンスが完了するまで発行してはなりません。時期尚早に呼び出されると、エンジンがまだアクティブな状態でレスポンスを破棄してしまい、クラッシュを引き起こす可能性があります。
[virtual] QString QQuickImageResponse::errorString() const
ジョブの実行に関するエラー文字列を返します。空の文字列はエラーがないことを意味します。
[signal] void QQuickImageResponse::finished()
ジョブの実行が完了したことを示すシグナル（正常に完了した場合、エラーが発生した場合、またはキャンセルされた場合を含む）。
注： このシグナルの発火は 、レスポンスが実行する最後のアクションでなければなりません。シグナルが受信されると、レスポンスはその後エンジンによって破棄されます。
[pure virtual] QQuickTextureFactory *QQuickImageResponse::textureFactory() const
ジョブのテクスチャファクトリを返します。プロバイダが `QImage` に対応している場合は、QQuickTextureFactory::textureFactoryForImage を使用できます。エンジンは、返された `QQuickTextureFactory` の所有権を取得します。
注：このメソッドは 、必要な場合にのみ呼び出されます。たとえば、エラーが発生した場合やジョブがキャンセルされた場合は、呼び出されない可能性があります。したがって、QQuickTextureFactory インスタンスの割り当ては、このメソッド内で行うか、あるいは確実に削除するようにしてください。
© 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.
