Qt PDF
El módulo Qt PDF contiene clases y funciones para renderizar documentos PDF. La clase QPdfDocument carga un documento PDF y renderiza sus páginas según las opciones proporcionadas por la clase QPdfDocumentRenderOptions. La clase QPdfPageRenderer gestiona una cola que recoge todas las peticiones de renderizado. La clase QPdfPageNavigator gestiona la navegación a través de un documento PDF. La clase QPdfSearchModel busca una cadena y almacena los resultados de la búsqueda. La clase QPdfBookmarkModel contiene el índice, si existe. La clase QPdfLinkModel contiene información sobre los hipervínculos de una página. El widget QPdfView es un visor de PDF completo, y el ejemplo de widget visor de PDF muestra cómo utilizarlo.
Para las aplicaciones Qt Quick, se proporcionan tres tipos de componentes de visor con todas las funciones. PdfMultiPageView debería ser su primera opción para la experiencia de usuario más común: desplazarse por las páginas del documento completo. PdfScrollablePageView muestra una página cada vez, con desplazamiento; y PdfPageView muestra una página completa cada vez, sin desplazamiento.
Los componentes del visor completo se componen de componentes QML de nivel inferior que pueden utilizarse por separado si necesita escribir una aplicación de visualización de PDF más personalizada: PdfDocument, PdfPageImage, PdfPageNavigator, PdfSelection, PdfSearchModel, PdfLinkModel, y PdfBookmarkModel.
Si sólo necesita renderizar imágenes de páginas, sin funciones como selección de texto, búsqueda y navegación, este módulo incluye un plugin QImageIOHandler que trata PDF como un formato de imagen escalable, similar a SVG. Sólo tiene que utilizar Image y establecer la propiedad currentFrame en el índice de la página que desea mostrar. Si el archivo PDF no renderiza su propio fondo, la imagen tendrá un fondo transparente.
Uso del módulo
El uso de un módulo Qt requiere la vinculación con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación tienen soporte dedicado para esto, incluyendo CMake y qmake.
Construir con CMake
Utilice el comando find_package() para localizar los componentes necesarios del módulo en el paquete Qt6:
find_package(Qt6 REQUIRED COMPONENTS Pdf) target_link_libraries(mytarget Qt6::Pdf)
Véase también la descripción general de la compilación con CMake.
Construcción con qmake
Para enlazar con el módulo, añada esta línea a su archivo de proyecto qmake:
QT += pdf
Ejemplos
Referencia API
Artículos y guías
Licencias y atribuciones
Qt PDF está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Consulte Qt PDF Licencias para más detalles sobre este módulo.
© 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.
