QPagedPaintDevice¶

PyQt5.QtGui.QPagedPaintDevice

Description¶

The QPagedPaintDevice class is a represents a paintdevice that supports multiple pages.

Paged paint devices are used to generate output for printing or for formats like PDF. QPdfWriter and QPrinter inherit from it.

Classes¶

Margins

Enums¶

PageSize

This enum type lists the available page sizes as defined in the Postscript PPD standard. These values are duplicated in QPageSize and QPrinter.

The defined sizes are:

Due to historic reasons Executive is not the same as the standard Postscript and Windows Executive size, use ExecutiveStandard instead.

The Postscript standard size Folio is different to the Windows DMPAPER_FOLIO size, use the Postscript standard size FanFoldGermanLegal if needed.

Member	Value	Description
A0	5	841 x 1189 mm
A1	6	594 x 841 mm
A10	TODO	TODO
A2	7	420 x 594 mm
A3	8	297 x 420 mm
A3Extra	TODO	TODO
A4	0	210 x 297 mm, 8.26 x 11.69 inches
A4Extra	TODO	TODO
A4Plus	TODO	TODO
A4Small	TODO	TODO
A5	9	148 x 210 mm
A5Extra	TODO	TODO
A6	10	105 x 148 mm
A7	11	74 x 105 mm
A8	12	52 x 74 mm
A9	13	37 x 52 mm
AnsiA	Letter	= Letter
AnsiB	Ledger	= Ledger
AnsiC	TODO	TODO
AnsiD	TODO	TODO
AnsiE	TODO	TODO
ArchA	TODO	TODO
ArchB	TODO	TODO
ArchC	TODO	TODO
ArchD	TODO	TODO
ArchE	TODO	TODO
B0	14	1000 x 1414 mm
B1	15	707 x 1000 mm
B10	16	31 x 44 mm
B2	17	500 x 707 mm
B3	18	353 x 500 mm
B4	19	250 x 353 mm
B5	1	176 x 250 mm, 6.93 x 9.84 inches
B5Extra	TODO	TODO
B6	20	125 x 176 mm
B7	21	88 x 125 mm
B8	22	62 x 88 mm
B9	23	33 x 62 mm
C5E	24	163 x 229 mm
Comm10E	25	105 x 241 mm, U.S. Common 10 Envelope
Custom	30	Unknown, or a user defined size.
DLE	26	110 x 220 mm
DoublePostcard	TODO	TODO
Envelope10	Comm10E	=
Envelope11	TODO	TODO
Envelope12	TODO	TODO
Envelope14	TODO	TODO
Envelope9	TODO	TODO
EnvelopeB4	TODO	TODO
EnvelopeB5	TODO	TODO
EnvelopeB6	TODO	TODO
EnvelopeC0	TODO	TODO
EnvelopeC1	TODO	TODO
EnvelopeC2	TODO	TODO
EnvelopeC3	TODO	TODO
EnvelopeC4	TODO	TODO
EnvelopeC5	C5E	= C5E
EnvelopeC6	TODO	TODO
EnvelopeC65	TODO	TODO
EnvelopeC7	TODO	TODO
EnvelopeChou3	TODO	TODO
EnvelopeChou4	TODO	TODO
EnvelopeDL	DLE	= DLE
EnvelopeInvite	TODO	TODO
EnvelopeItalian	TODO	TODO
EnvelopeKaku2	TODO	TODO
EnvelopeKaku3	TODO	TODO
EnvelopeMonarch	TODO	TODO
EnvelopePersonal	TODO	TODO
EnvelopePrc1	TODO	TODO
EnvelopePrc10	TODO	TODO
EnvelopePrc2	TODO	TODO
EnvelopePrc3	TODO	TODO
EnvelopePrc4	TODO	TODO
EnvelopePrc5	TODO	TODO
EnvelopePrc6	TODO	TODO
EnvelopePrc7	TODO	TODO
EnvelopePrc8	TODO	TODO
EnvelopePrc9	TODO	TODO
EnvelopeYou4	TODO	TODO
Executive	4	7.5 x 10 inches, 190.5 x 254 mm
ExecutiveStandard	TODO	TODO
FanFoldGerman	TODO	TODO
FanFoldGermanLegal	TODO	TODO
FanFoldUS	TODO	TODO
Folio	27	210 x 330 mm
Imperial10x11	TODO	TODO
Imperial10x13	TODO	TODO
Imperial10x14	TODO	TODO
Imperial12x11	TODO	TODO
Imperial15x11	TODO	TODO
Imperial7x9	TODO	TODO
Imperial8x10	TODO	TODO
Imperial9x11	TODO	TODO
Imperial9x12	TODO	TODO
JisB0	TODO	TODO
JisB1	TODO	TODO
JisB10	TODO	TODO
JisB2	TODO	TODO
JisB3	TODO	TODO
JisB4	TODO	TODO
JisB5	TODO	TODO
JisB6	44	,
JisB7	TODO	TODO
JisB8	TODO	TODO
JisB9	TODO	TODO
LastPageSize	EnvelopeYou4	=
Ledger	28	431.8 x 279.4 mm
Legal	3	8.5 x 14 inches, 215.9 x 355.6 mm
LegalExtra	TODO	TODO
Letter	2	8.5 x 11 inches, 215.9 x 279.4 mm
LetterExtra	TODO	TODO
LetterPlus	TODO	TODO
LetterSmall	TODO	TODO
Note	TODO	TODO
NPaperSize	TODO	TODO
Postcard	TODO	TODO
Prc16K	TODO	TODO
Prc32K	TODO	TODO
Prc32KBig	TODO	TODO
Quarto	TODO	TODO
Statement	TODO	TODO
SuperA	TODO	TODO
SuperB	TODO	TODO
Tabloid	29	279.4 x 431.8 mm
TabloidExtra	TODO	TODO

PdfVersion

The enum describes the version of the PDF file that is produced by QPrinter or QPdfWriter.

Member	Value	Description
PdfVersion_1_4	0	A PDF 1.4 compatible document is produced.
PdfVersion_1_6	2	A PDF 1.6 compatible document is produced. This value was added in Qt 5.12.
PdfVersion_A1b	1	A PDF/A-1b compatible document is produced.

Methods¶

__init__(): Constructs a new paged paint device.

margins() → Margins

Returns the current margins of the paint device. The default is 0.

Margins are specified in millimeters.

See also

setMargins().

newPage() → bool: TODO

pageLayout() → QPageLayout

Returns the current page layout. Use this method to access the current QPageSize, Orientation, QMarginsF, fullRect() and paintRect().

Note that you cannot use the setters on the returned object, you must either call the individual QPagedPaintDevice setters or use setPageLayout().

pageSize() → PageSize: Returns the currently used page size.

See also

setPageSize().

pageSizeMM() → QSizeF: Returns the page size in millimeters.

See also

setPageSizeMM().

setMargins(Margins)

Sets the margins to be used to margins.

Margins are specified in millimeters.

The margins are purely a hint to the drawing method. They don’t affect the coordinate system or clipping.

See also

margins().

setPageLayout(QPageLayout) → bool: TODO

setPageMargins(QMarginsF) → bool: TODO

setPageMargins(QMarginsF, Unit) → bool: TODO

setPageOrientation(Orientation) → bool: TODO

setPageSize(PageSize): Sets the size of the a page to size.

See also

setPageSizeMM().

setPageSize(QPageSize) → bool: TODO

setPageSizeMM(QSizeF)

Sets the page size to size. size is specified in millimeters.

If the size matches a standard PageSize then that page size will be used, otherwise Custom will be set.

See also

pageSizeMM().