QQuickImageResponse Class
La clase QQuickImageResponse proporciona una interfaz para la carga asíncrona de imágenes en QQuickAsyncImageProvider. Más...
| Cabecera: | #include <QQuickImageResponse> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick)target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Hereda: | QObject |
Funciones Públicas
| QQuickImageResponse() | |
| virtual | ~QQuickImageResponse() override |
| virtual QString | errorString() const |
| virtual QQuickTextureFactory * | textureFactory() const = 0 |
Ranuras Públicas
| virtual void | cancel() |
Señales
| void | finished() |
Descripción detallada
El propósito de una respuesta de imagen es proporcionar una forma para que los trabajos del proveedor de imagen se ejecuten de forma asíncrona.
Las respuestas son eliminadas a través de deleteLater una vez que la señal finished() ha sido emitida. Si está utilizando QRunnable como base para su QQuickImageResponse asegúrese que el borrado automático esté deshabilitado.
Vea el Ejemplo de Proveedor de Respuesta de Imagen para una implementación completa.
Vea también QQuickImageProvider.
Documentación de Funciones Miembro
QQuickImageResponse::QQuickImageResponse()
Construye la respuesta de la imagen
[override virtual noexcept] QQuickImageResponse::~QQuickImageResponse()
Destruye la respuesta de la imagen
[virtual slot] void QQuickImageResponse::cancel()
Este método se utiliza para comunicar que el motor ya no necesita la respuesta.
Puede ser reimplementado para cancelar una petición en el lado del proveedor, sin embargo, no es obligatorio.
Un QQuickImageResponse cancelado aún necesita emitir finished() para que el motor pueda limpiar el QQuickImageResponse.
Nota: finished() no debe emitirse hasta que la respuesta esté completa, independientemente de si se ha llamado o no a cancel(). Si se llama antes de tiempo, el motor puede destruir la respuesta mientras todavía está activa, provocando un fallo.
[virtual] QString QQuickImageResponse::errorString() const
Devuelve la cadena de error de la ejecución del trabajo. Una cadena vacía significa que no hay error.
[signal] void QQuickImageResponse::finished()
Señala que la ejecución del trabajo ha finalizado (ya sea con éxito, porque se ha producido un error o porque se ha cancelado).
Nota: La emisión de esta señal debe ser la última acción que realice la respuesta: una vez recibida la señal, la respuesta será destruida posteriormente por el motor.
[pure virtual] QQuickTextureFactory *QQuickImageResponse::textureFactory() const
Devuelve la fábrica de texturas para el trabajo. Puedes usar QQuickTextureFactory::textureFactoryForImage si tu proveedor trabaja con QImage. El motor se apropia de la devuelta QQuickTextureFactory.
Nota: Este método será llamado sólo cuando sea necesario. Por ejemplo, puede que no se llame si hay un error o se cancela el trabajo. Por lo tanto, asigne la instancia QQuickTextureFactory sólo en este método o, de lo contrario, asegúrese de su eliminación.
© 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.
