QPdfPageRenderer Class
La clase QPdfPageRenderer encapsula el renderizado de páginas de un documento PDF. Más...
| Header: | #include <QPdfPageRenderer> |
| Inherits: | QObject |
Tipos Públicos
| enum class | RenderMode { MultiThreaded, SingleThreaded } |
Propiedades
- document : QPdfDocument*
- renderMode : RenderMode
Funciones públicas
| QPdfPageRenderer(QObject *parent) | |
| virtual | ~QPdfPageRenderer() override |
| QPdfDocument * | document() const |
| QPdfPageRenderer::RenderMode | renderMode() const |
| quint64 | requestPage(int pageNumber, QSize imageSize, QPdfDocumentRenderOptions options = QPdfDocumentRenderOptions()) |
| void | setDocument(QPdfDocument *document) |
| void | setRenderMode(QPdfPageRenderer::RenderMode mode) |
Señales
| void | documentChanged(QPdfDocument *document) |
| void | renderModeChanged(QPdfPageRenderer::RenderMode renderMode) |
Descripción Detallada
El QPdfPageRenderer contiene una cola que recoge todas las peticiones de renderizado que son invocadas a través de requestPage(). Dependiendo de la configuración de RenderMode el QPdfPageRenderer procesa esta cola en el hilo principal de la UI en la siguiente invocación del bucle de eventos (RenderMode::SingleThreaded) o en un hilo worker separado (RenderMode::MultiThreaded) y emite el resultado a través de la señal pageRendered() para cada petición una vez que el renderizado ha finalizado.
Véase también QPdfDocument.
Documentación de tipos de miembros
enum class QPdfPageRenderer::RenderMode
Este enum describe cómo se renderizan las páginas.
| Constante | Valor | Descripción |
|---|---|---|
QPdfPageRenderer::RenderMode::MultiThreaded | 0 | Todas las páginas se renderizan en un subproceso worker separado. |
QPdfPageRenderer::RenderMode::SingleThreaded | 1 | Todas las páginas se renderizan en el subproceso principal de la interfaz de usuario (por defecto). |
Véase también renderMode() y setRenderMode().
Documentación de propiedades
document : QPdfDocument*
Esta propiedad contiene la instancia del documento del que este objeto renderiza las páginas.
Por defecto, esta propiedad es nullptr.
Funciones de acceso:
| QPdfDocument * | document() const |
| void | setDocument(QPdfDocument *document) |
Señal de notificador:
| void | documentChanged(QPdfDocument *document) |
Véase también document(), setDocument(), y QPdfDocument.
renderMode : RenderMode
Esta propiedad contiene el modo que el renderizador utiliza para renderizar las páginas.
Por defecto, esta propiedad es RenderMode::SingleThreaded.
Funciones de acceso:
| QPdfPageRenderer::RenderMode | renderMode() const |
| void | setRenderMode(QPdfPageRenderer::RenderMode mode) |
Señal del notificador:
| void | renderModeChanged(QPdfPageRenderer::RenderMode renderMode) |
Véase también setRenderMode() y RenderMode.
Documentación de las funciones miembro
[explicit] QPdfPageRenderer::QPdfPageRenderer(QObject *parent)
Construye un objeto renderizador de páginas con el objeto padre parent.
[override virtual noexcept] QPdfPageRenderer::~QPdfPageRenderer()
Destruye el objeto renderizador de páginas.
QPdfDocument *QPdfPageRenderer::document() const
Devuelve el documento del que este objeto renderiza las páginas, o un nullptr si no se ha establecido ninguno antes.
Nota: Función Getter para la propiedad document.
Véase también setDocument() y QPdfDocument.
QPdfPageRenderer::RenderMode QPdfPageRenderer::renderMode() const
Devuelve el modo en que se renderizan las páginas.
Nota: Función Getter para la propiedad renderMode.
Véase también setRenderMode() y RenderMode.
quint64 QPdfPageRenderer::requestPage(int pageNumber, QSize imageSize, QPdfDocumentRenderOptions options = QPdfDocumentRenderOptions())
Solicita al renderizador que renderice la página pageNumber en un QImage de tamaño imageSize de acuerdo con el options proporcionado.
Una vez realizado el renderizado se emite la señal pageRendered() con el resultado como parámetro.
El valor devuelto es un ID que identifica unívocamente la petición de renderizado. Si una solicitud con los mismos parámetros está todavía en la cola, se devuelve el ID de esa solicitud en cola.
void QPdfPageRenderer::setDocument(QPdfDocument *document)
Establece el document desde el que este objeto renderiza las páginas.
Nota: Función Setter para la propiedad document.
Ver también document() y QPdfDocument.
void QPdfPageRenderer::setRenderMode(QPdfPageRenderer::RenderMode mode)
Establece el modo de renderizado de las páginas en mode.
Nota: Función Setter para la propiedad renderMode.
Véase también renderMode() y RenderMode.
© 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.
