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 继承自它。
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
当成功时。
返回当前页面的布局。使用此方法以访问当前 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 ().