En esta página

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

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:

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

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

ConstanteValorDescripción
QPrintPreviewWidget::SinglePageView0Un modo en el que se visualizan páginas individuales en la vista previa.
QPrintPreviewWidget::FacingPagesView1Un modo en el que se visualizan las páginas enfrentadas en la vista previa.
QPrintPreviewWidget::AllPagesView2Un 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.

ConstanteValorDescripción
QPrintPreviewWidget::CustomZoom0El zoom se establece en un valor personalizado.
QPrintPreviewWidget::FitToWidth1Este modo ajusta la página actual al ancho de la vista.
QPrintPreviewWidget::FitInView2Este 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.