En esta página

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

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:

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

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

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

ConstanteValorDescripción
QPrintPreviewWidget::CustomZoom0El zoom se ajusta a un valor de zoom 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 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.