QQuickImageResponse Class
La clase QQuickImageResponse ofrece una interfaz para la carga asíncrona de imágenes en QQuickAsyncImageProvider. Más información...
| Encabezado: | #include <QQuickImageResponse> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Heredado de: | 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 objetivo de una respuesta de imagen es proporcionar una forma de que los trabajos del proveedor de imágenes se ejecuten de manera asíncrona.
Las respuestas se eliminan mediante ` deleteLater ` una vez que se ha emitido la señal ` finished()`. Si utilizas ` QRunnable ` como base para tu `QQuickImageResponse`, asegúrate de que la eliminación automática esté desactivada.
Consulte el ejemplo de proveedor de respuestas de imagen para ver una implementación completa.
Véase también QQuickImageProvider.
Documentación de las funciones de miembro
QQuickImageResponse::QQuickImageResponse()
Crea la respuesta de imagen
[override virtual noexcept] QQuickImageResponse::~QQuickImageResponse()
Elimina la respuesta de la imagen
[virtual slot] void QQuickImageResponse::cancel()
Este método se utiliza para indicar que el motor ya no necesita la respuesta.
Se puede reimplementar para cancelar una solicitud en el lado del proveedor; sin embargo, no es obligatorio.
Un ` QQuickImageResponse ` cancelado debe seguir emitiendo ` finished()` para que el motor pueda liberar el ` QQuickImageResponse`.
Nota: No se debe emitir` finished()` hasta que la respuesta esté completa, independientemente de si se ha llamado o no a `cancel()`. Si se llama prematuramente, el motor podría destruir la respuesta mientras aún está activa, lo que provocaría un fallo del sistema.
[virtual] QString QQuickImageResponse::errorString() const
Devuelve la cadena de error correspondiente a la ejecución del trabajo. Una cadena vacía indica que no se ha producido ningún error.
[signal] void QQuickImageResponse::finished()
Indica que la ejecución de la tarea 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, el motor destruirá posteriormente la respuesta.
[pure virtual] QQuickTextureFactory *QQuickImageResponse::textureFactory() const
Devuelve la fábrica de texturas para el trabajo. Puedes utilizar ` QQuickTextureFactory::textureFactoryForImage ` si tu proveedor funciona con ` QImage`. El motor asume la propiedad del objeto ` QQuickTextureFactory` devuelto.
Nota: Este método solo se invocará cuando sea necesario. Por ejemplo, es posible que no se invoque si se produce un error o si se cancela el trabajo. Por lo tanto, asigne la instancia de ` QQuickTextureFactory ` únicamente en este método o, en su defecto, asegúrese de eliminarla.
© 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.