QPagedPaintDevice 类

QPagedPaintDevice 类表示支持多页的描绘设备。 更多...

Header: #include <QPagedPaintDevice>
CMake: find_package(Qt6 COMPONENTS Gui REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
继承: QPaintDevice
继承者:

QPdfWriter and QPrinter

公共类型

enum PdfVersion { PdfVersion_1_4, PdfVersion_A1b, PdfVersion_1_6 }

公共函数

virtual ~QPagedPaintDevice ()
virtual bool newPage () = 0
QPageLayout pageLayout () const
QPageRanges pageRanges () const
virtual bool setPageLayout (const QPageLayout & newPageLayout )
virtual bool setPageMargins (const QMarginsF & margins , QPageLayout::Unit units = QPageLayout::Millimeter)
virtual bool setPageOrientation (QPageLayout::Orientation orientation )
virtual void setPageRanges (const QPageRanges & ranges )
virtual bool setPageSize (const QPageSize & pageSize )

详细描述

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

成员类型文档编制

enum QPagedPaintDevice:: PdfVersion

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

常量 描述
QPagedPaintDevice::PdfVersion_1_4 0 A PDF 1.4 compatible document is produced.
QPagedPaintDevice::PdfVersion_A1b 1 A PDF/A-1b compatible document is produced.
QPagedPaintDevice::PdfVersion_1_6 2 A PDF 1.6 compatible document is produced. This value was added in Qt 5.12.

成员函数文档编制

[virtual] QPagedPaintDevice:: ~QPagedPaintDevice ()

销毁对象。

[pure virtual] bool QPagedPaintDevice:: newPage ()

Starts a new page. Returns true 当成功时。

[since 5.3] QPageLayout QPagedPaintDevice:: pageLayout () const

返回当前页面的布局。使用此方法以访问当前 QPageSize , QPageLayout::Orientation , QMarginsF ,fullRect() 和 paintRect()。

注意:不可以在返回对象上使用 Setter,必须单独调用 QPagedPaintDevice setters or use setPageLayout ().

该函数在 Qt 5.3 引入。

另请参阅 setPageLayout (), setPageSize (), setPageOrientation (),和 setPageMargins ().

[since 6.0] QPageRanges QPagedPaintDevice:: pageRanges () const

Returns the page ranges associated with this device.

该函数在 Qt 6.0 引入。

另请参阅 setPageRanges (), QPageRanges , QPrinter::fromPage (),和 QPrinter::toPage ().

[virtual, since 5.3] bool QPagedPaintDevice:: setPageLayout (const QPageLayout & newPageLayout )

Sets the page layout to newPageLayout .

应先调用这当调用 QPainter::begin (),或立即调用在调用 newPage () 以将新页面布局应用到新页面之前。不应调用任何描绘方法,在调用 setPageLayout() 和 newPage () 之间因为可能使用了错误的描绘规格。

返回 true 若页面布局被成功设为 newPageLayout .

该函数在 Qt 5.3 引入。

另请参阅 pageLayout ().

[virtual, since 5.3] bool QPagedPaintDevice:: setPageMargins (const QMarginsF & margins , QPageLayout::Unit units = QPageLayout::Millimeter)

Set the page margins 定义以给定 units .

应先调用这当调用 QPainter::begin (),或立即调用在调用 newPage () 以将新边距应用到新页面之前。不应调用任何描绘方法,在调用 setPageMargins() 和 newPage () 之间因为可能使用了错误的描绘规格。

要获取当前页面边距,使用 pageLayout ().margins().

返回 true 若页面边距被成功设为 margins .

该函数在 Qt 5.3 引入。

另请参阅 pageLayout ().

[virtual, since 5.3] bool QPagedPaintDevice:: setPageOrientation ( QPageLayout::Orientation orientation )

Sets the page orientation .

页面取向用于定义页面大小的取向,当获取页面矩形时。

应先调用这当调用 QPainter::begin (),或立即调用在调用 newPage () 以将新取向应用到新页面之前。不应调用任何描绘方法,在调用 setPageOrientation() 和 newPage () 之间因为可能使用了错误的描绘规格。

要获取当前 QPageLayout::Orientation use pageLayout ().orientation().

返回 true 若页面取向被成功设为 orientation .

该函数在 Qt 5.3 引入。

另请参阅 pageLayout ().

[virtual, since 6.0] void QPagedPaintDevice:: setPageRanges (const QPageRanges & ranges )

Sets the page ranges for this device to ranges .

该函数在 Qt 6.0 引入。

另请参阅 pageRanges ().

[virtual, since 5.3] bool QPagedPaintDevice:: setPageSize (const QPageSize & pageSize )

Sets the page size to pageSize .

要获取当前 QPageSize use pageLayout ().pageSize().

应先调用这当调用 QPainter::begin (),或立即调用在调用 newPage () 以将新页面尺寸应用到新页面之前。不应调用任何描绘方法,在调用 setPageSize() 和 newPage () 之间因为可能使用了错误的描绘规格。

返回 true 若页面大小被成功设为 pageSize .

该函数在 Qt 5.3 引入。

另请参阅 pageLayout ().