QPrintEngine Class
La clase QPrintEngine define una interfaz para el modo en que QPrinter interactúa con un subsistema de impresión determinado. Más...
| Cabecera: | #include <QPrintEngine> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS PrintSupport)target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
- Lista de todos los miembros, incluidos los heredados
- QPrintEngine es parte de Printer y Printing APIs.
Nota: Todas las funciones de esta clase son reentrantes.
Tipos Públicos
| enum | PrintEnginePropertyKey { PPK_CollateCopies, PPK_ColorMode, PPK_Creator, PPK_Duplex, PPK_DocumentName, …, PPK_CustomBase } |
Funciones Públicas
| virtual | ~QPrintEngine() |
| virtual bool | abort() = 0 |
| virtual int | metric(QPaintDevice::PaintDeviceMetric id) const = 0 |
| virtual bool | newPage() = 0 |
| virtual QPrinter::PrinterState | printerState() const = 0 |
| virtual QVariant | property(QPrintEngine::PrintEnginePropertyKey key) const = 0 |
| virtual void | setProperty(QPrintEngine::PrintEnginePropertyKey key, const QVariant &value) = 0 |
Descripción Detallada
El caso común al crear tu propio motor de impresión es derivar tanto de QPaintEngine como de QPrintEngine. Varias propiedades de un motor de impresión se dan con property() y se establecen con setProperty().
Véase también QPaintEngine.
Documentación de tipos de miembros
enum QPrintEngine::PrintEnginePropertyKey
Este enum se utiliza para comunicar propiedades entre la impresora y QPrinter. Una propiedad puede o no estar soportada por una impresora determinada.
| Constante | Valor | Descripción |
|---|---|---|
QPrintEngine::PPK_CollateCopies | 0 | Valor booleano que indica si la impresión debe intercalarse o no. |
QPrintEngine::PPK_ColorMode | 1 | Se refiere a QPrinter::ColorMode, ya sea en color o monocromo. |
QPrintEngine::PPK_Creator | 2 | Una cadena que describe al creador del documento. |
QPrintEngine::PPK_Duplex | 20 | Un valor booleano que indica si se deben utilizar las dos caras del papel de la impresora para la impresión. |
QPrintEngine::PPK_DocumentName | 3 | Una cadena que describe el nombre del documento en el spooler. |
QPrintEngine::PPK_FontEmbedding | 19 | Un valor booleano que indica si los datos de las fuentes del documento deben incrustarse en los datos enviados a la impresora. |
QPrintEngine::PPK_FullPage | 4 | Un valor booleano que describe si la impresora debe imprimir a página completa o no. |
QPrintEngine::PPK_NumberOfCopies | 5 | Obsoleto. Un número entero que especifica el número de copias. Utilice PPK_CopyCount en su lugar. |
QPrintEngine::PPK_Orientation | 6 | Especifica un valor QPageLayout::Orientation. |
QPrintEngine::PPK_OutputFileName | 7 | El nombre del archivo de salida como cadena. Un nombre de archivo vacío indica que la impresora no debe imprimir en un archivo. |
QPrintEngine::PPK_PageOrder | 8 | Especifica un valor QPrinter::PageOrder. |
QPrintEngine::PPK_PageRect | 9 | Un QRect que especifica el rectángulo de página. |
QPrintEngine::PPK_PageSize | 10 | Obsoleto. Utilice PPK_PaperSize en su lugar. |
QPrintEngine::PPK_PaperRect | 11 | QRect Especifica el rectángulo de papel. |
QPrintEngine::PPK_PaperSource | 12 | Especifica un valor QPrinter::PaperSource. |
QPrintEngine::PPK_PaperSources | 21 | Especifica más de un valor QPrinter::PaperSource. |
QPrintEngine::PPK_PaperName | 26 | Una cadena que especifica el nombre del papel. |
QPrintEngine::PPK_PaperSize | PPK_PageSize | Especifica un valor de QPrinter::PaperSize. |
QPrintEngine::PPK_PrinterName | 13 | Cadena que especifica el nombre de la impresora. |
QPrintEngine::PPK_PrinterProgram | 14 | Una cadena que especifica el nombre del programa de la impresora utilizado para imprimir, |
QPrintEngine::PPK_Resolution | 15 | Un entero que describe los puntos por pulgada para esta impresora. |
QPrintEngine::PPK_SelectionOption | 16 | |
QPrintEngine::PPK_SupportedResolutions | 17 | Una lista de enteros QVariants que describen el conjunto de resoluciones soportadas por la impresora. |
QPrintEngine::PPK_WindowsPageSize | 18 | Un entero que especifica una entrada DM_PAPER en Windows. |
QPrintEngine::PPK_CustomPaperSize | 22 | Un QSizeF especificando un tamaño de papel personalizado en la unidad QPrinter::Point. |
QPrintEngine::PPK_PageMargins | 23 | Un QList<QVariant> que contiene los valores de los márgenes izquierdo, superior, derecho e inferior en la unidad QPrinter::Point. |
QPrintEngine::PPK_CopyCount | 24 | Un número entero que especifica el número de copias a imprimir. |
QPrintEngine::PPK_SupportsMultipleCopies | 25 | Un valor booleano que indica si la impresora admite o no la impresión de varias copias en un mismo trabajo. |
QPrintEngine::PPK_QPageSize | 27 | Establezca el tamaño de página utilizando un objeto QPageSize. |
QPrintEngine::PPK_QPageMargins | 28 | Establezca los márgenes de la página utilizando un par std::de QMarginsF y QPageLayout::Unit. |
QPrintEngine::PPK_QPageLayout | 29 | Establezca el diseño de página utilizando un objeto QPageLayout. |
QPrintEngine::PPK_CustomBase | 0xff00 | Base para la ampliación. |
Documentación de las funciones miembro
[virtual noexcept] QPrintEngine::~QPrintEngine()
Destruye la impresora.
[pure virtual] bool QPrintEngine::abort()
Ordena a la impresora que aborte el proceso de impresión. Devuelve true si tiene éxito; en caso contrario devuelve false.
[pure virtual] int QPrintEngine::metric(QPaintDevice::PaintDeviceMetric id) const
Devuelve la métrica de id.
[pure virtual] bool QPrintEngine::newPage()
Ordena a la impresora que inicie una nueva página. Devuelve true si la impresora ha podido crear la nueva página; en caso contrario, devuelve false.
[pure virtual] QPrinter::PrinterState QPrintEngine::printerState() const
Devuelve el estado actual de la impresora que está utilizando la impresora.
[pure virtual] QVariant QPrintEngine::property(QPrintEngine::PrintEnginePropertyKey key) const
Devuelve la propiedad de la impresora especificada por key.
Véase también setProperty().
[pure virtual] void QPrintEngine::setProperty(QPrintEngine::PrintEnginePropertyKey key, const QVariant &value)
Establece la propiedad de la impresora especificada por key a la dada value.
Véase también property().
© 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.
