QPagedPaintDevice 类

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

头: #include <QPagedPaintDevice>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
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
(从 6.0 起) 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 )
(从 6.0 起) virtual void setPageRanges (const QPageRanges & ranges )
virtual bool setPageSize (const QPageSize & pageSize )

详细描述

分页描绘设备用于为打印或像 PDF 的格式生成输出。 QPdfWriter and QPrinter 继承自它。

成员类型文档编制

enum QPagedPaintDevice:: PdfVersion

PdfVersion 枚举描述的 PDF 文件版本产生通过 QPrinter or QPdfWriter .

常量 描述
QPagedPaintDevice::PdfVersion_1_4 0 产生 PDF 1.4 兼容文档。
QPagedPaintDevice::PdfVersion_A1b 1 产生 PDF/A-1b 兼容文档。
QPagedPaintDevice::PdfVersion_1_6 2 产生 PDF 1.6 兼容文档。该值在 Qt 5.12 添加。

成员函数文档编制

[virtual noexcept] QPagedPaintDevice:: ~QPagedPaintDevice ()

销毁对象。

[pure virtual] bool QPagedPaintDevice:: newPage ()

开始新页面。返回 true 当成功时。

QPageLayout QPagedPaintDevice:: pageLayout () const

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

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

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

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

返回此设备关联的页面范围。

该函数在 Qt 6.0 引入。

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

[虚拟] bool QPagedPaintDevice:: setPageLayout (const QPageLayout & newPageLayout )

将页面布局设为 newPageLayout .

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

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

另请参阅 pageLayout ().

[虚拟] 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 .

另请参阅 pageLayout ().

[虚拟] bool QPagedPaintDevice:: setPageOrientation ( QPageLayout::Orientation orientation )

设置页面 orientation .

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

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

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

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

另请参阅 pageLayout ().

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

将此设备的页面范围设为 ranges .

该函数在 Qt 6.0 引入。

另请参阅 pageRanges ().

[虚拟] bool QPagedPaintDevice:: setPageSize (const QPageSize & pageSize )

将页面大小设为 pageSize .

要获取当前 QPageSize 使用 pageLayout ().pageSize().

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

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

另请参阅 pageLayout ().