QPrintPreviewDialog

The QPrintPreviewDialog class provides a dialog for previewing and configuring page layouts for printer output. More…

Synopsis

Functions

• def open (receiver, member)

• def printer ()

Signals

• def paintRequested (printer)

Detailed Description

Using QPrintPreviewDialog in your existing application is straightforward:

1. Create the QPrintPreviewDialog .

   You can construct a QPrintPreviewDialog with an existing QPrinter object, or you can have QPrintPreviewDialog create one for you, which will be the system default printer.

2. Connect the paintRequested() signal to a slot.

   When the dialog needs to generate a set of preview pages, the paintRequested() signal will be emitted. You can use the exact same code for the actual printing as for having the preview generated, including calling newPage() to start a new page in the preview. Connect a slot to the paintRequested() signal, where you draw onto the QPrinter object that is passed into the slot.

3. Call exec() .

   Call exec() to show the preview dialog.

See also

QPrinter QPrintDialog QPageSetupDialog QPrintPreviewWidget

class PySide6.QtPrintSupport.QPrintPreviewDialog(printer[, parent=None[, flags=Qt.WindowFlags()]])

PySide6.QtPrintSupport.QPrintPreviewDialog([parent=None[, flags=Qt.WindowFlags()]])

Parameters

• flags – WindowFlags

• printer – PySide6.QtPrintSupport.QPrinter

• parent – PySide6.QtWidgets.QWidget

Constructs a QPrintPreviewDialog based on printer and with parent as the parent widget. The widget flags flags are passed on to the QWidget constructor.

See also

setWindowFlags()

This is an overloaded function.

This will create an internal QPrinter object, which will use the system default printer.

PySide6.QtPrintSupport.QPrintPreviewDialog.open(receiver, member)

Parameters

• receiver – PySide6.QtCore.QObject

• member – str

This is an overloaded function.

Opens the dialog and connects its finished(int) signal to the slot specified by receiver and member.

The signal will be disconnected from the slot when the dialog is closed.

PySide6.QtPrintSupport.QPrintPreviewDialog.paintRequested(printer)

Parameters

printer – PySide6.QtPrintSupport.QPrinter

PySide6.QtPrintSupport.QPrintPreviewDialog.printer()

Return type

PySide6.QtPrintSupport.QPrinter

Returns a pointer to the QPrinter object this dialog is currently operating on.