En esta página

QPrintPreviewDialog Class

La clase QPrintPreviewDialog ofrece un cuadro de diálogo para previsualizar y configurar los diseños de página para la impresión. Más información...

Encabezado: #include <QPrintPreviewDialog>
CMake: find_package(Qt6 REQUIRED COMPONENTS PrintSupport)
target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)
qmake: QT += printsupport
Heredan: QDialog

Funciones públicas

QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
QPrintPreviewDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
virtual ~QPrintPreviewDialog()
void open(QObject *receiver, const char *member)
QPrinter *printer()

Funciones públicas reimplementadas

virtual void done(int result) override
virtual void setVisible(bool visible) override

Señales

void paintRequested(QPrinter *printer)

Descripción detallada

Utilizar QPrintPreviewDialog en tu aplicación existente es muy sencillo:

  1. Crea el objeto `QPrintPreviewDialog`.

    Puedes crear un objeto `QPrintPreviewDialog` a partir de un objeto ` QPrinter ` ya existente, o bien puedes hacer que `QPrintPreviewDialog` lo cree por ti, en cuyo caso se utilizará la impresora predeterminada del sistema.

  2. Conecta la señal paintRequested() a un slot.

    Cuando el cuadro de diálogo necesite generar un conjunto de páginas de vista previa, se emitirá la señal « paintRequested()». Puedes utilizar exactamente el mismo código para la impresión real que para generar la vista previa, incluida la llamada a « QPrinter::newPage()» para iniciar una nueva página en la vista previa. Conecta una ranura a la señal « paintRequested()», donde dibujarás sobre el objeto « QPrinter » que se pasa a la ranura.

  3. Llama a ` exec()`.

    Llama a QPrintPreviewDialog::exec() para mostrar el cuadro de diálogo de vista previa.

Véase también QPrinter, QPrintDialog, QPageSetupDialog y QPrintPreviewWidget.

Documentación de funciones miembro

[explicit] QPrintPreviewDialog::QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Crea un objeto `QPrintPreviewDialog` basado en ` printer ` y con ` parent ` como widget padre. Los indicadores del widget ` flags ` se pasan al constructor de ` QWidget `.

Véase también QWidget::setWindowFlags().

[explicit] QPrintPreviewDialog::QPrintPreviewDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Esto creará un objeto interno de tipo « QPrinter », que utilizará la impresora predeterminada del sistema.

Se trata de una función sobrecargada.

[virtual noexcept] QPrintPreviewDialog::~QPrintPreviewDialog()

Destruye el « QPrintPreviewDialog ».

[override virtual] void QPrintPreviewDialog::done(int result)

Reimplementa: ` QDialog::done` (int r).

void QPrintPreviewDialog::open(QObject *receiver, const char *member)

Abre el cuadro de diálogo y conecta su señal «finished(int)» a la ranura especificada por receiver y member.

La señal se desconectará del slot cuando se cierre el cuadro de diálogo.

[signal] void QPrintPreviewDialog::paintRequested(QPrinter *printer)

Esta señal se emite cuando el ` QPrintPreviewDialog ` necesita generar un conjunto de páginas de vista previa.

La instancia de « printer » proporcionada es el dispositivo de dibujo en el que debes dibujar el contenido de cada página, utilizando la instancia de « QPrinter » del mismo modo que lo harías al imprimir directamente.

QPrinter *QPrintPreviewDialog::printer()

Devuelve un puntero al objeto ` QPrinter ` sobre el que está operando actualmente este cuadro de diálogo.

[override virtual] void QPrintPreviewDialog::setVisible(bool visible)

Reimplementa: ` QDialog::setVisible` (`bool visible`).

© 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.