QPrintPreviewWidget Class
La clase QPrintPreviewWidget proporciona un widget para previsualizar los diseños de página para la salida de impresora. Más...
| Cabecera: | #include <QPrintPreviewWidget> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS PrintSupport)target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
| Hereda: | QWidget |
- Lista de todos los miembros, incluyendo los heredados
- QPrintPreviewWidget es parte de Impresora e Impresión APIs.
Tipos Públicos
| enum | ViewMode { SinglePageView, FacingPagesView, AllPagesView } |
| enum | ZoomMode { CustomZoom, FitToWidth, FitInView } |
Funciones Públicas
| QPrintPreviewWidget(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) | |
| QPrintPreviewWidget(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) | |
| virtual | ~QPrintPreviewWidget() |
| int | currentPage() const |
| QPageLayout::Orientation | orientation() const |
| int | pageCount() const |
| QPrintPreviewWidget::ViewMode | viewMode() const |
| qreal | zoomFactor() const |
| QPrintPreviewWidget::ZoomMode | zoomMode() const |
Funciones Públicas Reimplementadas
| virtual void | setVisible(bool visible) override |
Ranuras Públicas
| void | fitInView() |
| void | fitToWidth() |
| void | print() |
| void | setAllPagesViewMode() |
| void | setCurrentPage(int page) |
| void | setFacingPagesViewMode() |
| void | setLandscapeOrientation() |
| void | setOrientation(QPageLayout::Orientation orientation) |
| void | setPortraitOrientation() |
| void | setSinglePageViewMode() |
| void | setViewMode(QPrintPreviewWidget::ViewMode mode) |
| void | setZoomFactor(qreal factor) |
| void | setZoomMode(QPrintPreviewWidget::ZoomMode zoomMode) |
| void | updatePreview() |
| void | zoomIn(qreal factor = 1.1) |
| void | zoomOut(qreal factor = 1.1) |
Señales
| void | paintRequested(QPrinter *printer) |
| void | previewChanged() |
Descripción Detallada
QPrintPreviewDialog utiliza un QPrintPreviewWidget internamente, y el propósito de QPrintPreviewWidget es hacer posible incrustar la vista previa en otros widgets. También hace posible construir una interfaz de usuario diferente a la proporcionada por defecto con QPrintPreviewDialog.
Usar QPrintPreviewWidget es sencillo:
- Crear el QPrintPreviewWidget
Construya el QPrintPreviewWidget bien pasando un objeto QPrinter existente, o haga que QPrintPreviewWidget cree un objeto QPrinter construido por defecto para usted.
- Conecta la señal paintRequested() a un slot.
Cuando el widget necesite generar un conjunto de páginas de vista previa, emitirá una señal paintRequested(). Conecta una ranura a esta señal, y dibuja en el QPrinter pasado como parámetro de la señal. Llama a QPrinter::newPage(), para iniciar una nueva página en la vista previa.
Ver también QPrinter, QPrintDialog, QPageSetupDialog, y QPrintPreviewDialog.
Documentación de tipos de miembros
enum QPrintPreviewWidget::ViewMode
Este enum se utiliza para describir el modo de vista del widget de vista previa.
| Constante | Valor | Descripción |
|---|---|---|
QPrintPreviewWidget::SinglePageView | 0 | Un modo en el que se ven las páginas individuales de la vista previa. |
QPrintPreviewWidget::FacingPagesView | 1 | Un modo en el que se ven las páginas enfrentadas en la vista previa. |
QPrintPreviewWidget::AllPagesView | 2 | Un modo en el que se ven todas las páginas de la vista previa. |
enum QPrintPreviewWidget::ZoomMode
Este enum se utiliza para describir el modo de zoom del widget de vista previa.
| Constante | Valor | Descripción |
|---|---|---|
QPrintPreviewWidget::CustomZoom | 0 | El zoom se ajusta a un valor de zoom personalizado. |
QPrintPreviewWidget::FitToWidth | 1 | Este modo ajusta la página actual al ancho de la vista. |
QPrintPreviewWidget::FitInView | 2 | Este modo ajusta la página actual dentro de la vista. |
Documentación de las funciones miembro
[explicit] QPrintPreviewWidget::QPrintPreviewWidget(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Construye un QPrintPreviewWidget 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] QPrintPreviewWidget::QPrintPreviewWidget(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Esto hará que QPrintPreviewWidget cree un objeto interno, construido por defecto QPrinter, que se utilizará para generar la vista previa.
Esta es una función sobrecargada.
[virtual noexcept] QPrintPreviewWidget::~QPrintPreviewWidget()
Destruye el QPrintPreviewWidget.
int QPrintPreviewWidget::currentPage() const
Devuelve la página visualizada actualmente en la vista previa.
Véase también setCurrentPage().
[slot] void QPrintPreviewWidget::fitInView()
Se trata de una función de conveniencia y es lo mismo que llamar a setZoomMode(QPrintPreviewWidget::FitInView).
[slot] void QPrintPreviewWidget::fitToWidth()
Se trata de una función de conveniencia y es lo mismo que llamar a setZoomMode(QPrintPreviewWidget::FitToWidth).
QPageLayout::Orientation QPrintPreviewWidget::orientation() const
Devuelve la orientación actual de la vista previa. Este valor se obtiene del objeto QPrinter asociado a la vista previa.
Véase también setOrientation().
int QPrintPreviewWidget::pageCount() const
Devuelve el número de páginas de la vista previa.
[signal] void QPrintPreviewWidget::paintRequested(QPrinter *printer)
Esta señal se emite cuando el widget de vista previa necesita generar un conjunto de páginas de vista previa. printer es la impresora asociada a este widget de vista previa.
[signal] void QPrintPreviewWidget::previewChanged()
Esta señal se emite siempre que el widget de vista previa ha cambiado algún estado interno, como la orientación.
[slot] void QPrintPreviewWidget::print()
Imprime la vista previa en la impresora asociada a la vista previa.
[slot] void QPrintPreviewWidget::setAllPagesViewMode()
Se trata de una función de conveniencia y es lo mismo que llamar a setViewMode(QPrintPreviewWidget::AllPagesView).
[slot] void QPrintPreviewWidget::setCurrentPage(int page)
Establece la página actual en la vista previa. Esto hará que la vista salte al principio de page.
Véase también currentPage().
[slot] void QPrintPreviewWidget::setFacingPagesViewMode()
Se trata de una función de conveniencia y es lo mismo que llamar a setViewMode(QPrintPreviewWidget::FacingPagesView).
[slot] void QPrintPreviewWidget::setLandscapeOrientation()
Se trata de una función de conveniencia y es lo mismo que llamar a setOrientation(QPageLayout::Landscape).
[slot] void QPrintPreviewWidget::setOrientation(QPageLayout::Orientation orientation)
Establece la orientación actual en orientation. Este valor se establecerá en el objeto QPrinter asociado a la vista previa.
Véase también orientation().
[slot] void QPrintPreviewWidget::setPortraitOrientation()
Se trata de una función de conveniencia y es lo mismo que llamar a setOrientation(QPageLayout::Portrait).
[slot] void QPrintPreviewWidget::setSinglePageViewMode()
Se trata de una función de conveniencia y es lo mismo que llamar a setViewMode(QPrintPreviewWidget::SinglePageView).
[slot] void QPrintPreviewWidget::setViewMode(QPrintPreviewWidget::ViewMode mode)
Establece el modo de visualización en mode. El modo de visualización por defecto es SinglePageView.
Véase también viewMode().
[override virtual] void QPrintPreviewWidget::setVisible(bool visible)
[slot] void QPrintPreviewWidget::setZoomFactor(qreal factor)
Establece el factor de zoom de la vista en factor. Por ejemplo, un valor de 1,0 indica una vista sin escalar, que es aproximadamente el tamaño que tendrá la vista en papel. Un valor de 0,5 reducirá a la mitad el tamaño de la vista, mientras que un valor de 2,0 duplicará el tamaño de la vista.
Véase también zoomFactor().
[slot] void QPrintPreviewWidget::setZoomMode(QPrintPreviewWidget::ZoomMode zoomMode)
Establece el modo de zoom en zoomMode. El modo de zoom por defecto es FitInView.
Véase también zoomMode(), viewMode() y setViewMode().
[slot] void QPrintPreviewWidget::updatePreview()
Esta función actualiza la vista previa, lo que provoca la emisión de la señal paintRequested().
QPrintPreviewWidget::ViewMode QPrintPreviewWidget::viewMode() const
Devuelve el modo de vista actual. El modo de visualización por defecto es SinglePageView.
Véase también setViewMode().
qreal QPrintPreviewWidget::zoomFactor() const
Devuelve el factor de zoom de la vista.
Véase también setZoomFactor().
[slot] void QPrintPreviewWidget::zoomIn(qreal factor = 1.1)
Amplía la vista actual en factor. El valor por defecto de factor es 1,1, lo que significa que la vista se ampliará un 10%.
QPrintPreviewWidget::ZoomMode QPrintPreviewWidget::zoomMode() const
Devuelve el modo de zoom actual.
Véase también setZoomMode(), viewMode() y setViewMode().
[slot] void QPrintPreviewWidget::zoomOut(qreal factor = 1.1)
Reduce la vista actual en factor. El valor por defecto de factor es 1,1, lo que significa que la vista se reducirá un 10%.
© 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.