QPrinter Class
La clase QPrinter es un dispositivo de dibujo que dibuja en una impresora. Más información...
| Encabezado: | #include <QPrinter> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
| Heredado de: | QPagedPaintDevice |
- Lista de todos los miembros, incluidos los heredados
- QPrinter forma parte de las API de impresoras e impresión.
Nota: Todas las funciones de esta clase son reentrantes.
Tipos públicos
| enum | ColorMode { Color, GrayScale } |
| enum | DuplexMode { DuplexNone, DuplexAuto, DuplexLongSide, DuplexShortSide } |
| enum | OutputFormat { NativeFormat, PdfFormat } |
| enum | PageOrder { FirstPageFirst, LastPageFirst } |
| enum | PaperSource { Auto, Cassette, Envelope, EnvelopeManual, FormSource, …, LastPaperSource } |
| enum | PrintRange { AllPages, Selection, PageRange, CurrentPage } |
| enum | PrinterMode { ScreenResolution, PrinterResolution, HighResolution } |
| enum | PrinterState { Idle, Active, Aborted, Error } |
| enum | Unit { Millimeter, Point, Inch, Pica, Didot, …, DevicePixel } |
Funciones públicas
| QPrinter(QPrinter::PrinterMode mode = ScreenResolution) | |
| QPrinter(const QPrinterInfo &printer, QPrinter::PrinterMode mode = ScreenResolution) | |
| virtual | ~QPrinter() |
| bool | abort() |
| bool | collateCopies() const |
| QPrinter::ColorMode | colorMode() const |
| int | copyCount() const |
| QString | creator() const |
| QString | docName() const |
| QPrinter::DuplexMode | duplex() const |
| bool | fontEmbeddingEnabled() const |
| int | fromPage() const |
| bool | fullPage() const |
| bool | isValid() const |
| QString | outputFileName() const |
| QPrinter::OutputFormat | outputFormat() const |
| QPrinter::PageOrder | pageOrder() const |
| QRectF | pageRect(QPrinter::Unit unit) const |
| QRectF | paperRect(QPrinter::Unit unit) const |
| QPrinter::PaperSource | paperSource() const |
| QPagedPaintDevice::PdfVersion | pdfVersion() const |
| QPrintEngine * | printEngine() const |
| QString | printProgram() const |
| QPrinter::PrintRange | printRange() const |
| QString | printerName() const |
| QString | printerSelectionOption() const |
| QPrinter::PrinterState | printerState() const |
| int | resolution() const |
| void | setCollateCopies(bool collate) |
| void | setColorMode(QPrinter::ColorMode newColorMode) |
| void | setCopyCount(int count) |
| void | setCreator(const QString &creator) |
| void | setDocName(const QString &name) |
| void | setDuplex(QPrinter::DuplexMode duplex) |
| void | setFontEmbeddingEnabled(bool enable) |
| void | setFromTo(int from, int to) |
| void | setFullPage(bool fp) |
| void | setOutputFileName(const QString &fileName) |
| void | setOutputFormat(QPrinter::OutputFormat format) |
| void | setPageOrder(QPrinter::PageOrder pageOrder) |
| void | setPaperSource(QPrinter::PaperSource source) |
| void | setPdfVersion(QPagedPaintDevice::PdfVersion version) |
| void | setPrintProgram(const QString &printProg) |
| void | setPrintRange(QPrinter::PrintRange range) |
| void | setPrinterName(const QString &name) |
| void | setPrinterSelectionOption(const QString &option) |
| void | setResolution(int dpi) |
| QList<QPrinter::PaperSource> | supportedPaperSources() const |
| QList<int> | supportedResolutions() const |
| bool | supportsMultipleCopies() const |
| int | toPage() const |
Funciones públicas reimplementadas
| virtual bool | newPage() override |
| virtual QPaintEngine * | paintEngine() const override |
Funciones protegidas
| void | setEngines(QPrintEngine *printEngine, QPaintEngine *paintEngine) |
Descripción detallada
Este dispositivo representa una serie de páginas de salida impresa y se utiliza casi exactamente de la misma manera que otros dispositivos de dibujo, como QWidget y QPixmap. Se proporciona un conjunto de funciones adicionales para gestionar características específicas del dispositivo, como la orientación y la resolución, y para recorrer las páginas de un documento a medida que se genera.
Al imprimir directamente en una impresora en Windows o macOS, QPrinter utiliza los controladores de impresora integrados. En X11, QPrinter utiliza el Sistema Común de Impresión de Unix (CUPS) para enviar la salida en PDF a la impresora. Como alternativa, se puede utilizar la función printProgram() para especificar el comando o la utilidad que se va a utilizar en lugar de la predeterminada del sistema.
Ten en cuenta que la configuración de parámetros como el tamaño del papel y la resolución en una impresora no válida tiene un comportamiento indefinido. Puedes utilizar QPrinter::isValid() para verificarlo antes de cambiar cualquier parámetro.
QPrinter admite varios parámetros, la mayoría de los cuales pueden ser modificados por el usuario final mediante un print dialog. En general, QPrinter pasa estas funciones a la QPrintEngine subyacente.
Los parámetros más importantes son:
- setPageLayout() indica a QPrinter qué orientación de página debe utilizar y qué tamaño espera de la impresora.
- setResolution() indica a QPrinter qué resolución desea que ofrezca la impresora, en puntos por pulgada (DPI).
- setFullPage() indica a QPrinter si se desea imprimir la página completa o solo la parte en la que la impresora puede imprimir.
- setCopyCount() indica a QPrinter cuántas copias del documento debe imprimir.
Muchas de estas funciones solo se pueden invocar antes de que comience la impresión propiamente dicha (es decir, antes de que se llame a ` QPainter::begin()`). Esto suele tener sentido porque, por ejemplo, no es posible cambiar el número de copias cuando ya se está a mitad de la impresión. También hay algunos ajustes que configura el usuario (a través del cuadro de diálogo de la impresora) y que se espera que las aplicaciones respeten. Consulta la documentación de QAbstractPrintDialog para obtener más detalles.
Cuando se invoca a ` QPainter::begin()`, la impresora `QPrinter` sobre la que opera se prepara para una nueva página, lo que permite utilizar inmediatamente ` QPainter ` para dibujar la primera página de un documento. Una vez dibujada la primera página, se puede invocar a ` newPage()` para solicitar una nueva página en blanco sobre la que dibujar, o bien a ` QPainter::end()` para finalizar la impresión. La segunda página y todas las páginas siguientes se preparan mediante una llamada a newPage() antes de que se dibujen.
No es necesario que la primera página de un documento vaya precedida de una llamada a newPage(). Solo es necesario llamar a newPage() después de QPainter::begin() si necesitas insertar una página en blanco al principio de un documento impreso. Del mismo modo, llamar a newPage() después de que se haya pintado la última página de un documento dará como resultado que se añada una página en blanco al final del documento impreso.
Si desea abortar el trabajo de impresión, abort() hará todo lo posible por detener la impresión. Puede que cancele todo el trabajo o solo una parte del mismo.
Dado que QPrinter puede imprimir en cualquier subclase de QPrintEngine, es posible ampliar la compatibilidad de impresión para abarcar nuevos tipos de subsistemas de impresión creando una subclase de QPrintEngine y reimplementando su interfaz.
Véase también QPrintDialog y Qt Print Support.
Documentación sobre tipos de miembros
enum QPrinter::ColorMode
Este tipo de enumeración se utiliza para indicar si QPrinter debe mostrarse en color o no.
| Constante | Valor | Descripción |
|---|---|---|
QPrinter::Color | 1 | imprimir en color si está disponible; de lo contrario, en escala de grises. |
QPrinter::GrayScale | 0 | Imprimir en escala de grises, incluso en impresoras a color. |
enum QPrinter::DuplexMode
Esta enumeración se utiliza para indicar si la impresión se realizará en una o en ambas caras de cada hoja de papel (impresión a una cara o a doble cara).
| Constante | Valor | Descripción |
|---|---|---|
QPrinter::DuplexNone | 0 | Solo impresión a una cara (simplex). |
QPrinter::DuplexAuto | 1 | Se utiliza la configuración predeterminada de la impresora para determinar si se utiliza la impresión a doble cara. |
QPrinter::DuplexLongSide | 2 | Se utilizan ambas caras de cada hoja de papel para la impresión. El papel se da la vuelta por su borde más largo antes de imprimir la segunda cara |
QPrinter::DuplexShortSide | 3 | Se utilizan ambas caras de cada hoja de papel para la impresión. El papel se gira por su borde más corto antes de imprimir la segunda cara |
enum QPrinter::OutputFormat
La enumeración `OutputFormat` se utiliza para describir el formato que debe utilizar ` QPrinter ` para la impresión.
| Constante | Valor | Descripción |
|---|---|---|
QPrinter::NativeFormat | 0 | QPrinter imprimirá el resultado utilizando un método definido por la plataforma en la que se está ejecutando. Este modo es el predeterminado al imprimir directamente en una impresora. |
QPrinter::PdfFormat | 1 | QPrinter Generará la salida como un archivo PDF con capacidad de búsqueda. Este modo es el predeterminado al imprimir en un archivo. |
Véase también outputFormat(), setOutputFormat() y setOutputFileName().
enum QPrinter::PageOrder
QPrinter utiliza este tipo de enumeración para indicar al programa de aplicación cómo debe realizar la impresión.
| Constante | Valor | Descripción |
|---|---|---|
QPrinter::FirstPageFirst | 0 | La página con el número más bajo debe imprimirse primero. |
QPrinter::LastPageFirst | 1 | La página con el número más alto debe imprimirse primero. |
enum QPrinter::PaperSource
Este tipo de enumeración especifica qué fuente de papel debe utilizar QPrinter. QPrinter no comprueba si la fuente de papel está disponible; simplemente utiliza esta información para intentar configurar la fuente de papel. Que se configure o no la fuente de papel depende de si la impresora dispone de esa fuente en concreto.
Advertencia: Actualmente,esto solo está implementado para Windows.
| Constante | Valor | Descripción |
|---|---|---|
QPrinter::Auto | 6 | |
QPrinter::Cassette | 11 | |
QPrinter::Envelope | 4 | |
QPrinter::EnvelopeManual | 5 | |
QPrinter::FormSource | 12 | |
QPrinter::LargeCapacity | 10 | |
QPrinter::LargeFormat | 9 | |
QPrinter::Lower | 1 | |
QPrinter::MaxPageSource | 13 | Obsoleto; utilice «LastPaperSource» en su lugar |
QPrinter::Middle | 2 | |
QPrinter::Manual | 3 | |
QPrinter::OnlyOne | 0 | |
QPrinter::Tractor | 7 | |
QPrinter::SmallFormat | 8 | |
QPrinter::Upper | OnlyOne | |
QPrinter::CustomSource | 14 | Un PaperSource definido por la impresora que Qt desconoce |
QPrinter::LastPaperSource | CustomSource | El valor válido más alto de PaperSource; actualmente es CustomSource |
enum QPrinter::PrintRange
Se utiliza para especificar la opción de selección del rango de impresión.
| Constante | Valor | Descripción |
|---|---|---|
QPrinter::AllPages | 0 | Se deben imprimir todas las páginas. |
QPrinter::Selection | 1 | Solo se debe imprimir la selección. |
QPrinter::PageRange | 2 | Se debe imprimir el rango de páginas especificado. |
QPrinter::CurrentPage | 3 | Solo debe imprimirse la página actual. |
Véase también setPrintRange(), printRange() y QAbstractPrintDialog::PrintRange.
enum QPrinter::PrinterMode
Esta enumeración describe el modo en el que debe funcionar la impresora. Básicamente, preestablece una resolución y un modo de funcionamiento determinados.
| Constante | Valor | Descripción |
|---|---|---|
QPrinter::ScreenResolution | 0 | Establece la resolución del dispositivo de impresión en la resolución de la pantalla. Esto tiene la gran ventaja de que los resultados obtenidos al imprimir coincidirán más o menos exactamente con lo que se ve en la pantalla. Es la opción más fácil de usar, ya que las métricas de las fuentes en la pantalla y en la impresora son las mismas. Este es el valor por defecto. ScreenResolution producirá una salida de menor calidad que HighResolution y solo debería utilizarse para borradores. |
QPrinter::PrinterResolution | 1 | Este valor está obsoleto. Para impresoras, equivale a ScreenResolution en Unix y a HighResolution en Windows y macOS. Para la impresión en PDF, no es compatible y puede dar lugar a un comportamiento indefinido. El uso de este valor puede dar lugar a código de impresora no portátil. |
QPrinter::HighResolution | 2 | En Windows, establece la resolución de la impresora en la definida para la impresora en uso. Para la impresión de PDF, establece la resolución del controlador de PDF en 1200 ppp. Nota: Al renderizar texto en un dispositivo « QPrinter », es importante tener en cuenta que el tamaño del texto, cuando se especifica en puntos, es independiente de la resolución especificada para el propio dispositivo. Por lo tanto, puede resultar útil especificar el tamaño de la fuente en píxeles al combinar texto con gráficos, para garantizar que sus tamaños relativos sean los esperados. |
enum QPrinter::PrinterState
| Constante | Valor |
|---|---|
QPrinter::Idle | 0 |
QPrinter::Active | 1 |
QPrinter::Aborted | 2 |
QPrinter::Error | 3 |
enum QPrinter::Unit
Este tipo de enumeración se utiliza para especificar la unidad de medida de los tamaños de página y de papel.
| Constante | Valor |
|---|---|
QPrinter::Millimeter | 0 |
QPrinter::Point | 1 |
QPrinter::Inch | 2 |
QPrinter::Pica | 3 |
QPrinter::Didot | 4 |
QPrinter::Cicero | 5 |
QPrinter::DevicePixel | 6 |
Obsérvese la diferencia entre «Point» y «DevicePixel». La unidad «Point» se define como 1/72 de pulgada, mientras que la unidad «DevicePixel» depende de la resolución y se basa en los píxeles reales, o puntos, de la impresora.
Documentación de las funciones de miembro
[explicit] QPrinter::QPrinter(QPrinter::PrinterMode mode = ScreenResolution)
Crea un nuevo objeto de impresora con el ` mode` indicado.
[explicit] QPrinter::QPrinter(const QPrinterInfo &printer, QPrinter::PrinterMode mode = ScreenResolution)
Crea un nuevo objeto de impresora con los valores indicados en « printer » y « mode ».
[virtual noexcept] QPrinter::~QPrinter()
Destruye el objeto de la impresora y libera los recursos asignados. Si se destruye la impresora mientras hay un trabajo de impresión en curso, esto puede afectar o no a dicho trabajo.
bool QPrinter::abort()
Cancela el trabajo de impresión actual. Devuelve ` true ` si el trabajo de impresión se ha cancelado correctamente y ` printerState()` devolverá ` QPrinter::Aborted`; en caso contrario, devuelve ` false`.
No siempre es posible cancelar un trabajo de impresión. Por ejemplo, puede que todos los datos se hayan enviado a la impresora, pero que esta no pueda o no quiera cancelar el trabajo cuando se le solicite.
bool QPrinter::collateCopies() const
Devuelve « true » si la función de ordenación está activada cuando se selecciona la opción de copias múltiples. Devuelve « false » si está desactivada cuando se selecciona la opción de copias múltiples. Cuando la función de ordenación está desactivada, la impresión de cada página individual se repetirá el número indicado por «numCopies()» veces antes de que comience la página siguiente. Con la función de ordenación activada, todas las páginas se imprimen antes de que comience la siguiente copia de dichas páginas.
Véase también setCollateCopies().
QPrinter::ColorMode QPrinter::colorMode() const
Devuelve el modo de color actual.
Véase también setColorMode().
int QPrinter::copyCount() const
Devuelve el número de copias que se imprimirán. El valor por defecto es 1.
Véase también setCopyCount() y supportsMultipleCopies().
QString QPrinter::creator() const
Devuelve el nombre de la aplicación que creó el documento.
Véase también setCreator().
QString QPrinter::docName() const
Devuelve el nombre del documento.
Véase también setDocName() y QPrintEngine::PrintEnginePropertyKey.
QPrinter::DuplexMode QPrinter::duplex() const
Devuelve el modo dúplex actual.
Véase también setDuplex().
bool QPrinter::fontEmbeddingEnabled() const
Devuelve « true » si la incrustación de fuentes está habilitada.
Véase también setFontEmbeddingEnabled().
int QPrinter::fromPage() const
Devuelve el número de la primera página de un rango de páginas que se van a imprimir (el parámetro «página inicial»). Las páginas de un documento se numeran según la convención de que la primera página es la página 1.
Por defecto, esta función devuelve un valor especial de 0, lo que significa que el parámetro «página inicial» no está definido.
Nota: Si tanto fromPage() como toPage() devuelven 0, esto indica que se imprimirá el documento completo.
Véase también setFromTo(), toPage() y pageRanges().
bool QPrinter::fullPage() const
Devuelve « true » si el origen del sistema de coordenadas de la impresora se encuentra en la esquina de la página y «false» si se encuentra en el borde del área imprimible.
Consulte setFullPage() para obtener más detalles y advertencias.
Véanse también setFullPage() y QPagedPaintDevice::pageLayout().
bool QPrinter::isValid() const
Devuelve « true » si la impresora seleccionada actualmente es una impresora válida del sistema o una impresora PDF pura; en caso contrario, devuelve « false ».
Para detectar otros errores, comprueba el resultado de QPainter::begin() o QPrinter::newPage().
QPrinter impresora;
impresora.setOutputFormat(QPrinter::PdfFormat);
printer.setOutputFileName("/foobar/nonwritable.pdf");
QPainter painter;
if (! painter.begin(&printer)) { // no se ha podido abrir el archivo
qWarning("failed to open file, is it writable?");
return 1;
}
painter.drawText(10, 10, "Test");
if (! printer.newPage()) {
qWarning("failed in flushing page to disk, disk full?");
return 1;
}
painter.drawText(10, 10, "Prueba 2");
painter.end();Véase también setPrinterName().
[override virtual] bool QPrinter::newPage()
Reimplementa: QPagedPaintDevice::newPage().
Indica a la impresora que expulse la página actual y continúe imprimiendo en una nueva página. Devuelve ` true ` si la operación se ha realizado correctamente; en caso contrario, devuelve ` false`.
La llamada a newPage() sobre un objeto QPrinter inactivo siempre fallará.
QString QPrinter::outputFileName() const
Devuelve el nombre del archivo de salida. Por defecto, es una cadena vacía (lo que indica que la impresora no debe imprimir en un archivo).
Véase también setOutputFileName() y QPrintEngine::PrintEnginePropertyKey.
QPrinter::OutputFormat QPrinter::outputFormat() const
Devuelve el formato de salida de esta impresora.
Véase también ` setOutputFormat()`.
QPrinter::PageOrder QPrinter::pageOrder() const
Devuelve el orden actual de las páginas.
El orden predeterminado de las páginas es FirstPageFirst.
Véase también setPageOrder().
QRectF QPrinter::pageRect(QPrinter::Unit unit) const
Devuelve el rectángulo de la página en unit; suele ser más pequeño que el de paperRect(), ya que la página suele tener márgenes entre sus bordes y el papel.
Véase también QPagedPaintDevice::pageLayout().
[override virtual] QPaintEngine *QPrinter::paintEngine() const
Reimplementa: ` QPaintDevice::paintEngine()` const.
Devuelve el motor de dibujo utilizado por la impresora.
QRectF QPrinter::paperRect(QPrinter::Unit unit) const
Devuelve el rectángulo del papel en ` unit`; suele ser más grande que el de ` pageRect()`.
Véase también pageRect().
QPrinter::PaperSource QPrinter::paperSource() const
Devuelve la fuente de papel de la impresora. Puede ser Manual, una bandeja de la impresora o un casete de papel.
Véase también setPaperSource().
QPagedPaintDevice::PdfVersion QPrinter::pdfVersion() const
Devuelve la versión en PDF correspondiente a esta impresora. El valor por defecto es PdfVersion_1_4.
Véase también setPdfVersion().
QPrintEngine *QPrinter::printEngine() const
Devuelve el motor de impresión que utiliza la impresora.
QString QPrinter::printProgram() const
Devuelve el nombre del programa que envía la salida de impresión a la impresora.
Por defecto, devuelve una cadena vacía; esto significa que QPrinter intentará actuar de forma inteligente según el sistema en cuestión. Solo en X11, puedes establecer un valor diferente para utilizar un programa de impresión específico. En las demás plataformas, devuelve una cadena vacía.
Véase también setPrintProgram() y setPrinterSelectionOption().
QPrinter::PrintRange QPrinter::printRange() const
Devuelve el rango de páginas del objeto « QPrinter ». Una vez abierto el cuadro de diálogo de configuración de impresión, esta función devuelve el valor seleccionado por el usuario.
Véase también setPrintRange().
QString QPrinter::printerName() const
Devuelve el nombre de la impresora. Este valor se establece inicialmente en el nombre de la impresora predeterminada.
Véase también setPrinterName().
QString QPrinter::printerSelectionOption() const
Devuelve la cadena de selección de opciones de la impresora. Esto solo resulta útil si se ha establecido explícitamente el comando de impresión.
El valor por defecto (una cadena vacía) implica que la impresora debe seleccionarse en función del sistema.
Cualquier otro valor implica que se debe utilizar el valor proporcionado.
Esta función siempre devuelve una cadena vacía en Windows y Mac.
Véase también setPrinterSelectionOption() y setPrintProgram().
QPrinter::PrinterState QPrinter::printerState() const
Devuelve el estado actual de la impresora. Es posible que esta información no siempre sea precisa (por ejemplo, si la impresora no tiene la capacidad de comunicar su estado al sistema operativo).
int QPrinter::resolution() const
Devuelve la resolución actual asignada a la impresora, tal y como se ha configurado mediante la función setResolution() o mediante el controlador de la impresora.
Véase también setResolution().
void QPrinter::setCollateCopies(bool collate)
Establece el valor por defecto de la casilla de selección «Ordenar» cuando aparece el cuadro de diálogo de impresión. Si « collate » es «true», habilitará la función «setCollateCopiesEnabled()». El valor por defecto es «false». Este valor se modificará en función de lo que seleccione el usuario en el cuadro de diálogo de impresión.
Véase también collateCopies().
void QPrinter::setColorMode(QPrinter::ColorMode newColorMode)
Establece el modo de color de la impresora en « newColorMode », que puede ser « Color » o « GrayScale ».
Véase también colorMode().
void QPrinter::setCopyCount(int count)
Establece el número de copias que se van a imprimir en count.
El controlador de la impresora lee esta configuración e imprime el número de copias especificado.
Véase también copyCount() y supportsMultipleCopies().
void QPrinter::setCreator(const QString &creator)
Establece el nombre de la aplicación que creó el documento como « creator ».
Esta función solo es aplicable a la versión X11 de Qt. Si no se especifica ningún nombre de creador, este se establecerá como «Qt» seguido de un número de versión.
Véase también creator().
void QPrinter::setDocName(const QString &name)
Establece el nombre del documento como « name ».
En X11, el nombre del documento se utiliza, por ejemplo, como nombre de archivo de salida predeterminado en QPrintDialog. Ten en cuenta que el nombre del documento no afecta al nombre del archivo si la impresora está imprimiendo en un archivo. Para ello, utiliza la función setOutputFile().
Véanse también ` docName()` y ` QPrintEngine::PrintEnginePropertyKey`.
void QPrinter::setDuplex(QPrinter::DuplexMode duplex)
Permite la impresión a doble cara según el modo « duplex ».
Véase también « duplex » ().
[protected] void QPrinter::setEngines(QPrintEngine *printEngine, QPaintEngine *paintEngine)
Las subclases de ` QPrinter ` utilizan esta función para especificar motores de impresión y de dibujo personalizados (printEngine y paintEngine, respectivamente).
QPrinter no asume la propiedad de los motores, por lo que debes gestionar tú mismo estas instancias de motor.
Ten en cuenta que al cambiar los motores se restablecerá el estado de la impresora y todas sus propiedades.
Véanse también printEngine(), paintEngine() y setOutputFormat().
void QPrinter::setFontEmbeddingEnabled(bool enable)
Activa o desactiva la incrustación de fuentes en función de enable.
Véase también fontEmbeddingEnabled().
void QPrinter::setFromTo(int from, int to)
Establece el rango de páginas que se van a imprimir, de modo que abarque las páginas con los números especificados en from y to, donde from corresponde a la primera página del rango y to corresponde a la última.
Nota: Las páginas de un documento se numeran según la convención de que la primera página es la página 1. Sin embargo, si tanto from como to se establecen en 0, se imprimirá el documento completo.
Esta función se utiliza principalmente para establecer un valor por defecto que el usuario puede anular en el cuadro de diálogo de impresión al llamar a setup().
Véase también fromPage(), toPage() y pageRanges().
void QPrinter::setFullPage(bool fp)
Si fp es verdadero, habilita la posibilidad de dibujar en toda la página; en caso contrario, limita el dibujo al área imprimible indicada por el dispositivo.
Por defecto, la impresión a página completa está desactivada. En este caso, el origen del sistema de coordenadas de ` QPrinter` coincide con la esquina superior izquierda del área imprimible.
Si la impresión a página completa está habilitada, el origen del sistema de coordenadas de ` QPrinter` coincide con la esquina superior izquierda del propio papel. En este caso, la función ` device metrics ` indicará exactamente las mismas dimensiones que las indicadas por `{QPageSize}`. Es posible que no se pueda imprimir en toda la página física debido a los márgenes de la impresora, por lo que la aplicación debe tener en cuenta los márgenes por sí misma.
Véase también fullPage(), QPagedPaintDevice::pageLayout() y QPagedPaintDevice::setPageSize().
void QPrinter::setOutputFileName(const QString &fileName)
Establece el nombre del archivo de salida en « fileName ».
Si se establece un nombre nulo o vacío (0 o ""), se desactiva la impresión en un archivo. Si se establece un nombre no vacío, se activa la impresión en un archivo.
Esto puede modificar el valor de ` outputFormat()`. Si el nombre del archivo tiene la extensión «.pdf», se genera un PDF. Si el nombre del archivo tiene una extensión distinta de «.pdf», el formato de salida utilizado es el establecido con ` setOutputFormat()`.
QPrinter Utiliza los motores de impresión PDF multiplataforma de Qt, respectivamente. Si puedes generar este formato de forma nativa —por ejemplo, macOS puede generar archivos PDF desde su motor de impresión—, vuelve a establecer el formato de salida en NativeFormat.
Véanse también outputFileName() y setOutputFormat().
void QPrinter::setOutputFormat(QPrinter::OutputFormat format)
Establece el formato de salida de esta impresora en « format ».
Si « format » tiene el mismo valor que el establecido actualmente, no se realizará ningún cambio.
Si « format » es « NativeFormat », entonces « printerName » se establecerá en la impresora predeterminada. Si no hay ninguna impresora válida configurada, no se realizará ningún cambio. Si deseas establecer « NativeFormat » con un « printerName » específico, utiliza « setPrinterName()».
Véase también outputFormat() y setPrinterName().
void QPrinter::setPageOrder(QPrinter::PageOrder pageOrder)
Establece el orden de las páginas en pageOrder.
El orden de las páginas puede ser QPrinter::FirstPageFirst o QPrinter::LastPageFirst. La aplicación se encarga de leer el orden de las páginas e imprimirlas en consecuencia.
Esta función resulta especialmente útil para establecer un valor por defecto que el usuario puede modificar en el cuadro de diálogo de impresión.
Esta función solo es compatible con X11.
Véase también pageOrder().
void QPrinter::setPaperSource(QPrinter::PaperSource source)
Establece la configuración de la fuente de papel en « source ».
Solo en Windows: esta opción se puede modificar durante la impresión y surtirá efecto a partir de la siguiente llamada a ` newPage()`
Véase también ` paperSource()`.
void QPrinter::setPdfVersion(QPagedPaintDevice::PdfVersion version)
Establece la versión de PDF de esta impresora en « version ».
Si version tiene el mismo valor que el establecido actualmente, no se realizará ningún cambio.
Véase también pdfVersion().
void QPrinter::setPrintProgram(const QString &printProg)
Establece el nombre del programa que debe encargarse del trabajo de impresión como « printProg ».
En X11, esta función establece el programa al que se debe llamar con la salida en PDF. En otras plataformas, no tiene ningún efecto.
Véase también printProgram().
void QPrinter::setPrintRange(QPrinter::PrintRange range)
Establece la opción de rango de impresión en « range ».
Véase también printRange().
void QPrinter::setPrinterName(const QString &name)
Establece el nombre de la impresora como « name ».
Si el campo « name » está vacío, el formato de salida se establecerá en « PdfFormat ».
Si « name » no es una impresora válida, no se realizará ningún cambio.
Si « name » es una impresora válida, el formato de salida se establecerá en « NativeFormat ».
Véase también printerName(), isValid() y setOutputFormat().
void QPrinter::setPrinterSelectionOption(const QString &option)
Configura la impresora para que utilice ` option ` a la hora de seleccionarla. Por defecto, ` option ` es nulo (lo que implica que Qt debería ser lo suficientemente inteligente como para adivinarla correctamente), pero se puede establecer en otros valores para utilizar una opción específica de selección de impresora.
Si se cambia la opción de selección de impresora mientras la impresora está activa, el trabajo de impresión actual puede verse afectado o no.
Esta función no tiene ningún efecto en Windows ni en Mac.
Véase también printerSelectionOption() y setPrintProgram().
void QPrinter::setResolution(int dpi)
Indica a la impresora que imprima a una resolución de dpi o lo más cercana posible a dpi.
Esta configuración afecta al sistema de coordenadas devuelto, por ejemplo, por QPainter::viewport().
Para que surta efecto en todas las plataformas, esta función debe invocarse antes de QPainter::begin().
Véanse también resolution() y QPagedPaintDevice::setPageSize().
QList<QPrinter::PaperSource> QPrinter::supportedPaperSources() const
Devuelve los tamaños de papel compatibles con esta impresora.
Los valores serán o bien un valor que coincida con una entrada de la enumeración ` QPrinter::PaperSource `, o bien un valor específico del controlador. Los valores específicos del controlador son mayores que la constante `DMBIN_USER` declarada en `wingdi.h`.
Advertencia: esta función solo está disponible en Windows.
QList<int> QPrinter::supportedResolutions() const
Devuelve una lista de las resoluciones (una lista de números enteros que indican puntos por pulgada) que la impresora indica que admite.
En el caso de X11, donde toda la impresión se realiza directamente a PDF, esta función siempre devolverá una lista de un único elemento que contenga únicamente la resolución del PDF, es decir, 72 (72 ppp; véase PrinterMode).
bool QPrinter::supportsMultipleCopies() const
Devuelve « true » si la impresora admite la impresión de varias copias del mismo documento en un solo trabajo; en caso contrario, devuelve «false».
En la mayoría de los sistemas, esta función devolverá «true». Sin embargo, en los sistemas X11 que no admiten CUPS, esta función devolverá «false». Esto significa que la aplicación debe gestionar el número de copias imprimiendo el mismo documento el número de veces necesario.
Véase también setCopyCount() y copyCount().
int QPrinter::toPage() const
Devuelve el número de la última página de un rango de páginas que se van a imprimir (el parámetro «página hasta»). Las páginas de un documento se numeran según la convención de que la primera página es la página 1.
Por defecto, esta función devuelve un valor especial de 0, lo que significa que el parámetro «página hasta» no está definido.
Nota: Si tanto ` fromPage()` como `toPage()` devuelven 0, esto indica que se imprimirá todo el documento.
El programador es responsable de leer esta configuración e imprimir en consecuencia.
Véanse también setFromTo(), fromPage() y pageRanges().
© 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.