QPrintPreviewWidget Class
La clase QPrintPreviewWidget proporciona un widget para previsualizar los diseños de página para la impresión. Más información ...
| Encabezado: | #include <QPrintPreviewWidget> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
| Heredado de: | QWidget |
- Lista de todos los miembros, incluidos los heredados
- QPrintPreviewWidget forma parte de las API de impresoras e impresión.
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 internamente un QPrintPreviewWidget, y el objetivo de QPrintPreviewWidget es permitir incrustar la vista previa en otros widgets. También permite crear una interfaz de usuario diferente a la predeterminada que proporciona QPrintPreviewDialog.
El uso de QPrintPreviewWidget es sencillo:
- Crea el QPrintPreviewWidget
Inicializa el `QPrintPreviewWidget` pasando un objeto ` QPrinter ` ya existente, o bien deja que el propio `QPrintPreviewWidget` cree por ti un objeto ` QPrinter ` con la construcción por defecto.
- Conecta la señal paintRequested() a un slot.
Cuando el widget necesite generar un conjunto de páginas de vista previa, emitirá la señal « paintRequested()». Conecta un slot a esta señal y dibuja sobre el objeto « QPrinter » pasado como parámetro de la señal. Llama a « QPrinter::newPage()» para iniciar una nueva página en la vista previa.
Véase también QPrinter, QPrintDialog, QPageSetupDialog y QPrintPreviewDialog.
Documentación sobre tipos de miembros
enum QPrintPreviewWidget::ViewMode
Esta enumeración se utiliza para describir el modo de visualización del widget de vista previa.
| Constante | Valor | Descripción |
|---|---|---|
QPrintPreviewWidget::SinglePageView | 0 | Un modo en el que se visualizan páginas individuales en la vista previa. |
QPrintPreviewWidget::FacingPagesView | 1 | Un modo en el que se visualizan las páginas enfrentadas en la vista previa. |
QPrintPreviewWidget::AllPagesView | 2 | Un modo de visualización en el que se ven todas las páginas de la vista previa. |
enum QPrintPreviewWidget::ZoomMode
Esta enumeración se utiliza para describir el modo de zoom del widget de vista previa.
| Constante | Valor | Descripción |
|---|---|---|
QPrintPreviewWidget::CustomZoom | 0 | El zoom se establece en un valor 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 funciones de miembro
[explicit] QPrintPreviewWidget::QPrintPreviewWidget(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Crea un QPrintPreviewWidget basado en printer y con parent como widget padre. Los parámetros del widget flags se pasan al constructor QWidget.
Véase también QWidget::setWindowFlags().
[explicit] QPrintPreviewWidget::QPrintPreviewWidget(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Esto hará que QPrintPreviewWidget cree un objeto ` QPrinter ` interno, construido de forma predeterminada, que se utilizará para generar la vista previa.
Se trata de una función sobrecargada.
[virtual noexcept] QPrintPreviewWidget::~QPrintPreviewWidget()
Destruye el « QPrintPreviewWidget ».
int QPrintPreviewWidget::currentPage() const
Devuelve la página que se está visualizando actualmente en la vista previa.
Véase también setCurrentPage().
[slot] void QPrintPreviewWidget::fitInView()
Se trata de una función de conveniencia y equivale a llamar a ` setZoomMode(QPrintPreviewWidget::FitInView)`.
[slot] void QPrintPreviewWidget::fitToWidth()
Se trata de una función de conveniencia y equivale a 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 cada vez que el widget de vista previa cambia algún estado interno, como la orientación.
[slot] void QPrintPreviewWidget::print()
Imprime la vista previa en la impresora asociada a dicha vista previa.
[slot] void QPrintPreviewWidget::setAllPagesViewMode()
Se trata de una función de conveniencia y equivale a 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 se salte hasta el principio de page.
Véase también currentPage().
[slot] void QPrintPreviewWidget::setFacingPagesViewMode()
Se trata de una función de conveniencia y equivale a llamar a ` setViewMode(QPrintPreviewWidget::FacingPagesView)`.
[slot] void QPrintPreviewWidget::setLandscapeOrientation()
Se trata de una función de conveniencia y equivale a llamar a ` setOrientation(QPageLayout::Landscape)`.
[slot] void QPrintPreviewWidget::setOrientation(QPageLayout::Orientation orientation)
Establece la orientación actual en « orientation ». Este valor se aplicará al 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 equivale a llamar a ` setOrientation(QPageLayout::Portrait)`.
[slot] void QPrintPreviewWidget::setSinglePageViewMode()
Se trata de una función de conveniencia y equivale a 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 predeterminado 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 lo duplicará.
Véase también zoomFactor().
[slot] void QPrintPreviewWidget::setZoomMode(QPrintPreviewWidget::ZoomMode zoomMode)
Establece el modo de zoom en « zoomMode ». El modo de zoom predeterminado es « FitInView ».
Véase también zoomMode(), viewMode() y setViewMode().
[slot] void QPrintPreviewWidget::updatePreview()
Esta función actualiza la vista previa, lo que provoca que se emita la señal paintRequested().
QPrintPreviewWidget::ViewMode QPrintPreviewWidget::viewMode() const
Devuelve el modo de visualización actual. El modo de visualización predeterminado 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 un porcentaje ( factor). El valor predeterminado 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)
Aleja la vista actual en un porcentaje de factor. El valor por defecto de factor es 1,1, lo que significa que la vista se reducirá en 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.