QPagedPaintDevice 类

成员函数文档

[虚拟 noexcept] QPagedPaintDevice::~QPagedPaintDevice()

销毁对象。

[纯虚函数] bool QPagedPaintDevice::newPage()

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

QPageLayout QPagedPaintDevice::pageLayout() const

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

注意，您不能使用返回对象的设置器，您必须调用单个 QPagedPaintDevice 设置器或使用 setPageLayout。

另请参阅 setPageLayout、setPageSize、setPageOrientation 和 setPageMargins。

[自 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 () 之间不应调用任何绘画方法，因为可能会使用错误的绘图度量。

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

另请参阅 pageLayout。

[虚函数] bool QPagedPaintDevice::setPageMargins(const QMarginsF &margins, QPageLayout::Unit units = QPageLayout::Millimeter)

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

在调用 QPainter::begin 之前调用此方法，或者立即在调用 newPage () 之前调用以将新的边距应用到新页上。在调用 setPageMargins() 和 newPage () 之间不应调用任何绘画方法，因为可能会使用错误的绘图度量。

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

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

另请参阅 pageLayout。

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

设置页面 orientation。

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

在使用 QPainter::begin() 或者在调用 newPage() 前立即调用此方法，以将新方向应用于新页面。在调用 setPageOrientation() 和 newPage() 之间不应调用任何绘画方法，因为可能会使用错误的绘图度量。

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

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

另请参阅 pageLayout。

[虚拟，自 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() 之间不应调用任何绘画方法，因为可能会使用错误的绘图度量。

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

另请参阅 pageLayout。