PySide6.QtGui.QPagedPaintDevice

class QPagedPaintDevice

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

PySide6.QtGui.QPagedPaintDevice 的继承图

继承者: QPrinter, QPdfWriter

概要

方法

虚拟方法

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题,您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

分页绘图设备用于生成打印输出或PDF等格式的输出。QPdfWriter 和 QPrinter 继承自它。

class PdfVersion

PdfVersion 枚举描述了由 QPrinter 或 QPdfWriter 生成的 PDF 文件的版本。

常量

描述

QPagedPaintDevice.PdfVersion_1_4

生成一个兼容PDF 1.4的文档。

QPagedPaintDevice.PdfVersion_A1b

生成一个与PDF/A-1b兼容的文档。

QPagedPaintDevice.PdfVersion_1_6

生成一个兼容PDF 1.6的文档。此值在Qt 5.12中添加。

QPagedPaintDevice.PdfVersion_X4

生成一个与PDF/X-4兼容的文档。

abstract newPage()
Return type:

布尔

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

pageLayout()
Return type:

QPageLayout

返回当前页面布局。使用此方法访问当前的QPageSizeOrientation、QMarginsF、fullRect()和paintRect()。

请注意,你不能在返回的对象上使用设置器,你必须调用单独的QPagedPaintDevice设置器或使用setPageLayout()

pageRanges()
Return type:

QPageRanges

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

另请参阅

setPageRanges() QPageRanges toPage()

setPageLayout(pageLayout)
Parameters:

页面布局QPageLayout

Return type:

布尔

将页面布局设置为 newPageLayout

你应该在调用begin()之前调用这个,或者在调用newPage()之前立即调用,以将新的页面布局应用到新页面。你不应该在调用setPageLayout()和newPage()之间调用任何绘画方法,因为可能会使用错误的绘画度量。

如果页面布局成功设置为newPageLayout,则返回true。

另请参阅

pageLayout()

setPageMargins(margins[, units=QPageLayout.Millimeter])
Parameters:
Return type:

布尔

设置页面在给定的units中定义的margins

你应该在调用begin()之前调用这个,或者在调用newPage()之前立即调用,以将新的边距应用到新页面。你不应该在调用setPageMargins()和newPage()之间调用任何绘画方法,因为可能会使用错误的绘画度量。

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

如果页面边距成功设置为 margins,则返回 true。

另请参阅

pageLayout()

setPageOrientation(orientation)
Parameters:

方向Orientation

Return type:

布尔

设置页面的orientation

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

你应该在调用begin()之前调用这个,或者在调用newPage()之前立即调用,以将新的方向应用到新页面。你不应该在调用setPageOrientation()和newPage()之间调用任何绘画方法,因为可能会使用错误的绘画度量。

要获取当前的Orientation,请使用pageLayout() .orientation()。

如果页面方向成功设置为orientation,则返回true。

另请参阅

pageLayout()

setPageRanges(ranges)
Parameters:

范围QPageRanges

设置此设备的页面范围为ranges

另请参阅

pageRanges()

setPageSize(pageSize)
Parameters:

pageSizeQPageSize

Return type:

布尔

将页面大小设置为 pageSize

要获取当前的QPageSize,请使用pageLayout().pageSize()。

你应该在调用begin()之前调用这个,或者在调用newPage()之前立即调用,以将新的页面大小应用到新页面。你不应该在调用setPageSize()和newPage()之间调用任何绘图方法,因为可能会使用错误的绘图度量。

如果页面大小成功设置为pageSize,则返回true。

另请参阅

pageLayout()