QPagedPaintDevice Class
QPagedPaintDevice クラスは、複数のページをサポートする描画デバイスを表します。詳細...
| ヘッダー: | #include <QPagedPaintDevice> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 継承元: | QPaintDevice |
| 継承元: |
- 継承されたメンバーを含むすべてのメンバーの一覧
- QPagedPaintDevice は、Painting クラス群の一部です。
パブリック型
| enum | PdfVersion { PdfVersion_1_4, PdfVersion_A1b, PdfVersion_1_6, PdfVersion_X4 } |
パブリック関数
| virtual | ~QPagedPaintDevice() |
| virtual bool | newPage() = 0 |
| QPageLayout | pageLayout() const |
(since 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) |
(since 6.0) virtual void | setPageRanges(const QPageRanges &ranges) |
| virtual bool | setPageSize(const QPageSize &pageSize) |
詳細な説明
ページ単位のペイント デバイスは、印刷や PDF などの形式の出力を生成するために使用されます。QPdfWriter およびQPrinter は、このクラスを継承しています。
メンバー型のドキュメント
enum QPagedPaintDevice::PdfVersion
PdfVersion 列挙型は、QPrinter またはQPdfWriter によって生成される PDF ファイルのバージョンを表します。
| 定数 | 値 | 説明 |
|---|---|---|
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 | PDF/X-4 準拠のドキュメントが生成されます。 |
メンバ関数のドキュメント
[virtual noexcept] QPagedPaintDevice::~QPagedPaintDevice()
そのオブジェクトを破棄します。
[pure virtual] bool QPagedPaintDevice::newPage()
新しいページを開始します。成功した場合はtrue を返します。
QPageLayout QPagedPaintDevice::pageLayout() const
現在のページレイアウトを返します。このメソッドを使用すると、現在のQPageSize 、QPageLayout::Orientation 、QMarginsF 、fullRect()、およびpaintRect()にアクセスできます。
なお、返されたオブジェクトに対してセッターを使用することはできません。個々のQPagedPaintDevice のセッターを呼び出すか、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()の呼び出しの間に描画メソッドを呼び出してはいけません。誤った描画メトリクスが使用される可能性があるためです。
ページレイアウトがnewPageLayout に正常に設定された場合、trueを返します。
pageLayout()も参照してください 。
[virtual] bool QPagedPaintDevice::setPageMargins(const QMarginsF &margins, QPageLayout::Unit units = QPageLayout::Millimeter)
指定されたunits で定義されたページmargins を設定します。
新しいページに新しい余白を適用するには、QPainter::begin() を呼び出す前、またはnewPage() を呼び出す直前に、このメソッドを呼び出す必要があります。setPageMargins() の呼び出しとnewPage() の呼び出しの間に描画メソッドを呼び出してはいけません。誤った描画メトリクスが使用される可能性があるためです。
現在のページの余白を取得するには、pageLayout() を使用します。margins() 。
ページの余白がmargins に正常に設定された場合、trueを返します。
pageLayout()も参照してください 。
[virtual] bool QPagedPaintDevice::setPageOrientation(QPageLayout::Orientation orientation)
ページorientation を設定します。
ページの向きは、ページ矩形を取得する際に、ページサイズの向きを定義するために使用されます。
QPainter::begin() を呼び出す前、または新しいページに新しい向きを適用するためにnewPage() を呼び出す直前に、このメソッドを呼び出す必要があります。setPageOrientation() の呼び出しとnewPage() の呼び出しの間に、ペイントメソッドを呼び出してはいけません。誤ったペイントメトリクスが使用される恐れがあるためです。
現在のQPageLayout::Orientation を取得するには、pageLayout().orientation()を使用します。
ページの向きがorientation に正常に設定された場合、trueを返します。
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() の呼び出しの間に、描画メソッドを呼び出してはなりません。誤った描画メトリクスが使用される可能性があるためです。
ページサイズがpageSize に正常に設定された場合、true を返します。
pageLayout()も参照してください 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.