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 |
- Lista de todos los miembros, incluidos los heredados
- QPrintPreviewDialog forma parte de los diálogos estándar y de las API de impresoras e impresión.
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:
- 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.
- 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.
- 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.