Qt Print Support
El módulo « Qt Print Support » ofrece una amplia compatibilidad multiplataforma para la impresión. Mediante los sistemas de impresión de cada plataforma, las aplicaciones Qt pueden imprimir en impresoras conectadas y, a través de redes, en impresoras remotas. El sistema de impresión también admite la generación de archivos PDF, lo que sienta las bases para funciones básicas de generación de informes.
Qt Print Support No está disponible en:
- Android™
- iOS
Clases que admiten la impresión
Las siguientes clases permiten seleccionar y configurar impresoras, así como la salida de impresión.
Implementación básica para los cuadros de diálogo de impresión utilizados para configurar impresoras | |
Representa una colección de rangos de páginas | |
Cuadro de diálogo de configuración para las opciones relacionadas con las páginas en una impresora | |
Cuadro de diálogo para especificar la configuración de la impresora | |
Define una interfaz que describe cómo interactúa QPrinter con un subsistema de impresión determinado | |
Cuadro de diálogo para previsualizar y configurar los diseños de página para la salida de la impresora | |
Componente para previsualizar los diseños de página para la salida de la impresora | |
Dispositivo de dibujo que dibuja en una impresora | |
Proporciona acceso a información sobre las impresoras existentes |
Dispositivos de dibujo e impresión
Las impresoras están representadas por QPrinter, un dispositivo de dibujo que proporciona funcionalidades específicas para la impresión, como la compatibilidad con varias páginas y la impresión a doble cara. Por lo tanto, la impresión implica utilizar un QPainter para dibujar en una serie de páginas, del mismo modo que se dibujaría en un widget personalizado o en una imagen.
Creación de un QPrinter
Aunque los objetos ` QPrinter ` pueden crearse y configurarse sin necesidad de que el usuario introduzca datos, la impresión suele realizarse a petición del usuario; por ejemplo, cuando el usuario selecciona la opción de menú « File|Print... » en una aplicación GUI. En tales casos, se pasa un objeto ` QPrinter ` recién creado a un ` QPrintDialog`, lo que permite al usuario especificar la impresora que se va a utilizar, el tamaño del papel y otras propiedades de impresión.
QPrinter printer;
QPrintDialog dialog(&printer, this);
dialog.setWindowTitle(tr("Print Document"));
if (editor->textCursor().hasSelection())
dialog.addEnabledOption(QAbstractPrintDialog::PrintSelection);
if (dialog.exec() != QDialog::Accepted)
return;También es posible establecer ciertas propiedades predeterminadas modificando el objeto QPrinter antes de pasarlo al cuadro de diálogo de impresión. Por ejemplo, las aplicaciones que generan lotes de informes para imprimir pueden configurar el objeto QPrinter para que utilice write to a local file de forma predeterminada, en lugar de una impresora.
Dibujar en una página
Una vez que se ha creado y configurado un objeto ` QPrinter `, se puede utilizar un ` QPainter ` para realizar operaciones de dibujo en él. Podemos crear y configurar un ` ` de la siguiente manera:
QPrinter printer(QPrinter::HighResolution);
printer.setOutputFileName("print.ps");
QPainter painter;
painter.begin(&printer);
for (int page = 0; page < numberOfPages; ++page) {
// Use the painter to draw on the page.
if (page != lastPage)
printer.newPage();
}
painter.end();Dado que el ` QPrinter ` comienza con una página en blanco, solo tenemos que llamar a la función ` newPage()` después de dibujar cada página, excepto la última.
El documento se envía a la impresora o se guarda en un archivo local cuando llamamos a end().
Sistemas de coordenadas
QPrinter proporciona funciones que pueden utilizarse para obtener información sobre las dimensiones del papel (el rectángulo del papel) y las dimensiones del área imprimible (el rectángulo de la página). Estas se expresan en coordenadas lógicas del dispositivo, que pueden diferir de las coordenadas físicas utilizadas por el propio dispositivo, lo que indica que la impresora es capaz de representar texto y gráficos a una resolución (normalmente mayor) que la de la pantalla del usuario.
Aunque no necesitamos encargarnos nosotros mismos de la conversión entre coordenadas lógicas y físicas, sí que debemos aplicar transformaciones a las operaciones de dibujo, ya que las medidas en píxeles utilizadas para dibujar en pantalla suelen ser demasiado pequeñas para las resoluciones más altas de las impresoras habituales.
| Sistemas de coordenadas de la impresora y del programa de dibujo Las funciones ` paperRect()` y ` pageRect()` proporcionan información sobre el tamaño del papel utilizado para la impresión y el área de este sobre la que se puede dibujar. El rectángulo devuelto por pageRect() suele estar dentro del rectángulo devuelto por paperRect(). No es necesario tener en cuenta las posiciones y los tamaños de estas áreas al utilizar un ` QPainter ` con un ` QPrinter ` como dispositivo de dibujo subyacente; el origen del sistema de coordenadas del dibujante coincidirá con la esquina superior izquierda del rectángulo de la página, y las operaciones de dibujo se recortarán a los límites de la parte dibujable de la página. | ![]() |
El sistema de dibujo utiliza automáticamente las métricas correctas del dispositivo al dibujar texto; sin embargo, si necesitas posicionar el texto utilizando información obtenida de las métricas de la fuente, debes asegurarte de que el dispositivo de impresión esté especificado al crear los objetos ` QFontMetrics ` y ` QFontMetricsF `, o bien asegurarte de que cada objeto ` QFont ` utilizado se cree mediante la forma del constructor que acepta un argumento ` QPaintDevice `.
Impresión de widgets
Para imprimir un widget, puedes utilizar la función ` QWidget::render()`. Como se ha mencionado, la resolución de la impresora suele ser mayor que la de la pantalla, por lo que tendrás que escalar el «painter». Es posible que también quieras colocar el widget en la página. El siguiente ejemplo de código muestra cómo se haría esto.
QPainter painter;
painter.begin(&printer);
const auto pageLayout = printer.pageLayout();
const auto pageRect = pageLayout.paintRectPixels(printer.resolution());
const auto paperRect = pageLayout.fullRectPixels(printer.resolution());
double xscale = pageRect.width() / double(myWidget->width());
double yscale = pageRect.height() / double(myWidget->height());
double scale = qMin(xscale, yscale);
painter.translate(pageRect.x() + paperRect.width() / 2.,
pageRect.y() + paperRect.height() / 2.);
painter.scale(scale, scale);
painter.translate(-myWidget->width() / 2., -myWidget->height() / 2.);
myWidget->render(&painter);Esto centrará el widget en la página y lo ajustará para que quepa en ella.
Impresión desde widgets complejos
Ciertos widgets, como QTextEdit y QGraphicsView, muestran contenido enriquecido que suele gestionarse mediante instancias de otras clases, como QTextDocument y QGraphicsScene. Por consiguiente, son estas clases de gestión de contenido las que suelen proporcionar la funcionalidad de impresión, ya sea a través de una función que permite realizar la tarea completa, o mediante una función que acepta un objeto QPainter ya existente. Algunos widgets proporcionan funciones de conveniencia para exponer las características de impresión subyacentes, lo que evita la necesidad de obtener el gestor de contenido solo para llamar a una única función.
La siguiente tabla muestra qué clase y función se encargan de la impresión desde una selección de diferentes widgets. En el caso de los widgets que no exponen directamente la funcionalidad de impresión, las clases de gestión de contenido que contienen esta funcionalidad pueden obtenerse a través de una función de la API del widget correspondiente.
| Widget | Función de impresión | Acepta |
|---|---|---|
| QGraphicsView | QGraphicsView::render() | QPainter |
| QSvgWidget | QSvgRenderer::render() | QPainter |
| QTextEdit | QTextDocument::print() | QPrinter |
| QTextLayout | QTextLayout::draw() | QPainter |
| QTextLine | QTextLine::draw() | QPainter |
QTextEdit requiere un « QPrinter » en lugar de un « QPainter », ya que utiliza información sobre las dimensiones configuradas de la página para insertar saltos de página en los lugares más adecuados de los documentos impresos.
Uso del módulo
Para utilizar un módulo Qt es necesario enlazar con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación ofrecen soporte específico para ello, entre ellas CMake y qmake.
Compilación con CMake
Utilice el comando « find_package() » para localizar los componentes del módulo necesarios en el paquete « Qt6 »:
find_package(Qt6 REQUIRED COMPONENTS PrintSupport)
target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)Consulta también la descripción general de «Compilación con CMake ».
Compilación con qmake
Para configurar el módulo para la compilación con qmake, añade el módulo como valor de la variable ` QT ` en el archivo `.pro` del proyecto:
QT += printsupportEvolución del módulo
La sección«Cambios en Qt Print Support » enumera los cambios importantes en la API y la funcionalidad del módulo que se han realizado para la serie Qt 6 de Qt.
Licencias y marcas registradas
El módulo Qt Print Support está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo licencias de software libre: la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Consulta Licencias de Qt para obtener más detalles.
Tenga en cuenta queAdobe® impone restricciones al uso de sus marcas registradas (incluidos los logotipos) en relación con el formato PDF; por ejemplo, «Adobe PDF». Consulte www.adobe.com para conocer las directrices.
© 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.
