QPrintPreviewWidget Class

The QPrintPreviewWidget class provides a widget for previewing page layouts for printer output. More...

Header:	#include <QPrintPreviewWidget>
qmake:	QT += printsupport
Since:	Qt 4.4
Inherits:	QWidget

This class was introduced in Qt 4.4.

List of all members, including inherited members

Public Types

enum	ViewMode { SinglePageView, FacingPagesView, AllPagesView }
enum	ZoomMode { CustomZoom, FitToWidth, FitInView }

Detailed Description

QPrintPreviewDialog uses a QPrintPreviewWidget internally, and the purpose of QPrintPreviewWidget is to make it possible to embed the preview into other widgets. It also makes it possible to build a different user interface around it than the default one provided with QPrintPreviewDialog.

Using QPrintPreviewWidget is straightforward:

Create the QPrintPreviewWidget
Construct the QPrintPreviewWidget either by passing in an existing QPrinter object, or have QPrintPreviewWidget create a default constructed QPrinter object for you.
Connect the paintRequested() signal to a slot.
When the widget needs to generate a set of preview pages, a paintRequested() signal will be emitted from the widget. Connect a slot to this signal, and draw onto the QPrinter passed in as a signal parameter. Call QPrinter::newPage(), to start a new page in the preview.

See also QPrinter, QPrintDialog, QPageSetupDialog, and QPrintPreviewDialog.

Member Type Documentation

enum QPrintPreviewWidget::ViewMode

This enum is used to describe the view mode of the preview widget.

Constant	Value	Description
`QPrintPreviewWidget::SinglePageView`	`0`	A mode where single pages in the preview is viewed.
`QPrintPreviewWidget::FacingPagesView`	`1`	A mode where the facing pages in the preview is viewed.
`QPrintPreviewWidget::AllPagesView`	`2`	A view mode where all the pages in the preview is viewed.

enum QPrintPreviewWidget::ZoomMode

This enum is used to describe zoom mode of the preview widget.

Constant	Value	Description
`QPrintPreviewWidget::CustomZoom`	`0`	The zoom is set to a custom zoom value.
`QPrintPreviewWidget::FitToWidth`	`1`	This mode fits the current page to the width of the view.
`QPrintPreviewWidget::FitInView`	`2`	This mode fits the current page inside the view.