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, PdfVersion_X4 }

公共函數

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 添加。
QPagedPaintDevice::PdfVersion_X4 (since Qt 6.8) 3 A PDF/X-4 compatible document is produced.

成員函數文檔編製

[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 ().

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

將頁麵布局設為 newPageLayout .

應先調用這當調用 QPainter::begin (),或立即調用在調用 newPage () 以將新頁麵布局應用到新頁麵之前。不應調用任何描繪方法,在調用 setPageLayout() 和 newPage () 之間因為可能使用瞭錯誤的描繪規格。

返迴 true 若頁麵布局被成功設為 newPageLayout .

另請參閱 pageLayout ().

[virtual] 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 ().

[virtual] 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 ().

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

將頁麵大小設為 pageSize .

要獲取當前 QPageSize 使用 pageLayout ().pageSize().

應先調用這當調用 QPainter::begin (),或立即調用在調用 newPage () 以將新頁麵尺寸應用到新頁麵之前。不應調用任何描繪方法,在調用 setPageSize() 和 newPage () 之間因為可能使用瞭錯誤的描繪規格。

返迴 true 若頁麵大小被成功設為 pageSize .

另請參閱 pageLayout ().