En esta página

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

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.

ConstanteValorDescripción
QPrintEngine::PPK_CollateCopies0Valor booleano que indica si la impresión debe clasificarse o no.
QPrintEngine::PPK_ColorMode1Hace referencia a QPrinter::ColorMode, ya sea en color o en monocromo.
QPrintEngine::PPK_Creator2Una cadena que describe al creador del documento.
QPrintEngine::PPK_Duplex20Un valor booleano que indica si deben utilizarse ambas caras del papel de la impresora para la impresión.
QPrintEngine::PPK_DocumentName3Una cadena que describe el nombre del documento en la cola de impresión.
QPrintEngine::PPK_FontEmbedding19Un valor booleano que indica si los datos de las fuentes del documento deben incluirse en los datos enviados a la impresora.
QPrintEngine::PPK_FullPage4Un valor booleano que indica si la impresión debe ocuparse toda la página o no.
QPrintEngine::PPK_NumberOfCopies5Obsoleto. Un entero que especifica el número de copias. Utiliza PPK_CopyCount en su lugar.
QPrintEngine::PPK_Orientation6Especifica un valor de « QPageLayout::Orientation ».
QPrintEngine::PPK_OutputFileName7El 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_PageOrder8Especifica un valor de « QPrinter::PageOrder ».
QPrintEngine::PPK_PageRect9Un objeto « QRect » que especifica el rectángulo de la página
QPrintEngine::PPK_PageSize10Obsoleto. Utilice PPK_PaperSize en su lugar.
QPrintEngine::PPK_PaperRect11Un valor de « QRect » que especifica el rectángulo del papel.
QPrintEngine::PPK_PaperSource12Especifica un valor de « QPrinter::PaperSource ».
QPrintEngine::PPK_PaperSources21Especifica más de un valor de « QPrinter::PaperSource ».
QPrintEngine::PPK_PaperName26Una cadena que especifica el nombre del papel.
QPrintEngine::PPK_PaperSizePPK_PageSizeEspecifica un valor de QPrinter::PaperSize.
QPrintEngine::PPK_PrinterName13Una cadena que especifica el nombre de la impresora.
QPrintEngine::PPK_PrinterProgram14Una cadena que especifica el nombre del programa de impresión utilizado para imprimir,
QPrintEngine::PPK_Resolution15Un entero que describe los puntos por pulgada de esta impresora.
QPrintEngine::PPK_SelectionOption16 
QPrintEngine::PPK_SupportedResolutions17Una lista de QVariants de tipo entero que describen el conjunto de resoluciones compatibles que admite la impresora.
QPrintEngine::PPK_WindowsPageSize18Un entero que especifica una entrada DM_PAPER en Windows.
QPrintEngine::PPK_CustomPaperSize22Un objeto « QSizeF » que especifica un tamaño de papel personalizado en la unidad « QPrinter::Point ».
QPrintEngine::PPK_PageMargins23Un objeto « QList » <QVariant> que contiene los valores de los márgenes izquierdo, superior, derecho e inferior en la unidad « QPrinter::Point ».
QPrintEngine::PPK_CopyCount24Un número entero que especifica el número de copias que se van a imprimir.
QPrintEngine::PPK_SupportsMultipleCopies25Un valor booleano que indica si la impresora admite o no la impresión de varias copias en un mismo trabajo.
QPrintEngine::PPK_QPageSize27Establece el tamaño de la página utilizando un objeto ` QPageSize `.
QPrintEngine::PPK_QPageMargins28Establece los márgenes de la página utilizando un std::pair de QMarginsF y QPageLayout::Unit.
QPrintEngine::PPK_QPageLayout29Establece el diseño de la página mediante un objeto ` QPageLayout `.
QPrintEngine::PPK_CustomBase0xff00Base 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.