QPrintPreviewDialog Class
La clase QPrintPreviewDialog proporciona un cuadro de diálogo para previsualizar y configurar los diseños de página para la salida de impresora. Más...
| Cabecera: | #include <QPrintPreviewDialog> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS PrintSupport)target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
| Hereda: | QDialog |
- Lista de todos los miembros, incluyendo los heredados
- QPrintPreviewDialog es parte de las APIs Estándar de Diálogos e 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 su aplicación es muy sencillo:
- Cree el QPrintPreviewDialog.
Puede construir un QPrintPreviewDialog con un objeto QPrinter existente, o puede hacer que QPrintPreviewDialog cree uno por usted, que será la impresora por defecto del sistema.
- Conecte la señal paintRequested() a una ranura.
Cuando el diálogo necesite generar un conjunto de páginas de vista previa, se emitirá la señal paintRequested(). Puede utilizar exactamente el mismo código para la impresión real como para tener la vista previa generada, incluyendo la llamada a QPrinter::newPage() para iniciar una nueva página en la vista previa. Conecte una ranura a la señal paintRequested(), donde dibujará sobre el objeto QPrinter que se pasa a la ranura.
- Llame a exec().
Llame a QPrintPreviewDialog::exec() para mostrar el diálogo de vista previa.
Vea también QPrinter, QPrintDialog, QPageSetupDialog, y QPrintPreviewWidget.
Documentación de las funciones miembro
[explicit] QPrintPreviewDialog::QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Construye un QPrintPreviewDialog basado en printer y con parent como widget padre. Las banderas del widget flags se pasan al constructor QWidget.
Ver también QWidget::setWindowFlags().
[explicit] QPrintPreviewDialog::QPrintPreviewDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Esto creará un objeto interno QPrinter, que utilizará la impresora por defecto del sistema.
Esta es 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 diálogo y conecta su señal finished(int) a la ranura especificada por receiver y member.
La señal se desconectará de la ranura cuando se cierre el diálogo.
[signal] void QPrintPreviewDialog::paintRequested(QPrinter *printer)
Esta señal se emite cuando QPrintPreviewDialog necesita generar un conjunto de páginas de previsualización.
La instancia printer suministrada es el dispositivo de pintura sobre el que debe pintar el contenido de cada página, utilizando la instancia QPrinter del mismo modo que lo haría al imprimir directamente.
QPrinter *QPrintPreviewDialog::printer()
Devuelve un puntero al objeto QPrinter sobre el que está operando actualmente este 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.
