内容

• 公共类型
• 公共函数
• 详细描述

QPagedPaintDevice 类

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

头：	#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 )

详细描述

分页描绘设备用于为打印或像 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 添加。

成员函数文档编制

[虚拟] QPagedPaintDevice:: ~QPagedPaintDevice ()

销毁对象。

[pure virtual] bool QPagedPaintDevice:: newPage ()

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

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

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

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

该函数在 Qt 5.3 引入。

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

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

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

该函数在 Qt 6.0 引入。

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

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

将页面布局设为 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 )

设置页面 orientation .

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

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

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

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

该函数在 Qt 5.3 引入。

另请参阅 pageLayout ().

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

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

该函数在 Qt 6.0 引入。

另请参阅 pageRanges ().

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

将页面大小设为 pageSize .

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

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

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

该函数在 Qt 5.3 引入。

另请参阅 pageLayout ().