QPrintEngine Class
La clase `QPrintEngine` define una interfaz que establece cómo interactu QPrinter con un subsistema de impresión determinado. Más información...
| Encabezado: | #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 forma parte de las API de impresoras e impresión.
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
Lo habitual al crear un motor de impresión propio es derivar tanto de ` QPaintEngine ` como de `QPrintEngine`. Las distintas propiedades de un motor de impresión se obtienen mediante ` property()` y se establecen mediante ` setProperty()`.
Véase también QPaintEngine.
Documentación sobre los tipos de miembros
enum QPrintEngine::PrintEnginePropertyKey
Esta enumeración se utiliza para comunicar propiedades entre el motor de impresión y QPrinter. Un motor de impresión concreto puede admitir o no una propiedad determinada.
| Constante | Valor | Descripción |
|---|---|---|
QPrintEngine::PPK_CollateCopies | 0 | Valor booleano que indica si la impresión debe clasificarse o no. |
QPrintEngine::PPK_ColorMode | 1 | Hace referencia a QPrinter::ColorMode, ya sea en color o en monocromo. |
QPrintEngine::PPK_Creator | 2 | Una cadena que describe al creador del documento. |
QPrintEngine::PPK_Duplex | 20 | Un valor booleano que indica si deben utilizarse ambas caras del papel de la impresora para la impresión. |
QPrintEngine::PPK_DocumentName | 3 | Una cadena que describe el nombre del documento en la cola de impresión. |
QPrintEngine::PPK_FontEmbedding | 19 | Un valor booleano que indica si los datos de las fuentes del documento deben incluirse en los datos enviados a la impresora. |
QPrintEngine::PPK_FullPage | 4 | Un valor booleano que indica si la impresión debe ocuparse toda la página o no. |
QPrintEngine::PPK_NumberOfCopies | 5 | Obsoleto. Un entero que especifica el número de copias. Utiliza PPK_CopyCount en su lugar. |
QPrintEngine::PPK_Orientation | 6 | Especifica un valor de « 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 de « QPrinter::PageOrder ». |
QPrintEngine::PPK_PageRect | 9 | Un objeto « QRect » que especifica el rectángulo de la página |
QPrintEngine::PPK_PageSize | 10 | Obsoleto. Utilice PPK_PaperSize en su lugar. |
QPrintEngine::PPK_PaperRect | 11 | Un valor de « QRect » que especifica el rectángulo del papel. |
QPrintEngine::PPK_PaperSource | 12 | Especifica un valor de « QPrinter::PaperSource ». |
QPrintEngine::PPK_PaperSources | 21 | Especifica más de un valor de « 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 | Una cadena que especifica el nombre de la impresora. |
QPrintEngine::PPK_PrinterProgram | 14 | Una cadena que especifica el nombre del programa de impresión utilizado para imprimir, |
QPrintEngine::PPK_Resolution | 15 | Un entero que describe los puntos por pulgada de esta impresora. |
QPrintEngine::PPK_SelectionOption | 16 | |
QPrintEngine::PPK_SupportedResolutions | 17 | Una lista de QVariants de tipo entero que describen el conjunto de resoluciones compatibles que admite la impresora. |
QPrintEngine::PPK_WindowsPageSize | 18 | Un entero que especifica una entrada DM_PAPER en Windows. |
QPrintEngine::PPK_CustomPaperSize | 22 | Un objeto « QSizeF » que especifica un tamaño de papel personalizado en la unidad « QPrinter::Point ». |
QPrintEngine::PPK_PageMargins | 23 | Un objeto « 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 que se van 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 | Establece el tamaño de la página utilizando un objeto ` QPageSize `. |
QPrintEngine::PPK_QPageMargins | 28 | Establece los márgenes de la página utilizando un std::pair de QMarginsF y QPageLayout::Unit. |
QPrintEngine::PPK_QPageLayout | 29 | Establece el diseño de la página mediante un objeto ` QPageLayout `. |
QPrintEngine::PPK_CustomBase | 0xff00 | Base para la extensión. |
Documentación de las funciones miembro
[virtual noexcept] QPrintEngine::~QPrintEngine()
Destruye el motor de impresión.
[pure virtual] bool QPrintEngine::abort()
Ordena al motor de impresión que interrumpa el proceso de impresión. Devuelve «true» si se realiza correctamente; en caso contrario, devuelve « false ».
[pure virtual] int QPrintEngine::metric(QPaintDevice::PaintDeviceMetric id) const
Devuelve la métrica correspondiente al id indicado.
[pure virtual] bool QPrintEngine::newPage()
Indica al motor de impresión 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 el motor de impresión.
[pure virtual] QVariant QPrintEngine::property(QPrintEngine::PrintEnginePropertyKey key) const
Devuelve la propiedad del motor de impresión especificada por key.
Véase también setProperty().
[pure virtual] void QPrintEngine::setProperty(QPrintEngine::PrintEnginePropertyKey key, const QVariant &value)
Establece la propiedad del motor de impresión especificada por « key » en el valor indicado « 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.