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 Classesの一部です。
パブリックタイプ
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 enum は、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()も参照 。
© 2025 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.