QPagedPaintDevice Class

QPagedPaintDevice クラスは、複数ページをサポートするペイント・デバイスを表します。詳細...

Header: #include <QPagedPaintDevice>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Inherits: QPaintDevice
Inherited By:

QPdfWriter and QPrinter

パブリック型

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のようなフォーマット用の出力を生成するために使用されます。QPdfWriterQPrinter はこのデバイスを継承しています。

メンバ型ドキュメント

enum QPagedPaintDevice::PdfVersion

PdfVersion enum は、QPrinter またはQPdfWriter によって生成される PDF ファイルのバージョンを記述します。

定数説明
QPagedPaintDevice::PdfVersion_1_40PDF 1.4 互換の文書が生成されます。
QPagedPaintDevice::PdfVersion_A1b1PDF/A-1b 互換文書が生成される。
QPagedPaintDevice::PdfVersion_1_62PDF 1.6 互換の文書が生成されます。この値は Qt 5.12 で追加されました。
QPagedPaintDevice::PdfVersion_X4 (since Qt 6.8)3PDF/X-4 互換の文書が生成されます。

メンバ関数 ドキュメント

[virtual noexcept] QPagedPaintDevice::~QPagedPaintDevice()

オブジェクトを破棄します。

[pure virtual] bool QPagedPaintDevice::newPage()

新しいページを開始します。成功するとtrue を返します。

QPageLayout QPagedPaintDevice::pageLayout() const

現在のページレイアウトを返します。このメソッドを使用して、現在のQPageSizeQPageLayout::OrientationQMarginsF 、 fullRect() および paintRect() にアクセスします。

返されたオブジェクトのセッターは使用できないことに注意してください。個々のQPagedPaintDevice セッターを呼び出すか、setPageLayout() を使用する必要があります。

setPageLayout()、setPageSize()、setPageOrientation()、setPageMargins()も参照

[since 6.0] QPageRanges QPagedPaintDevice::pageRanges() const

このデバイスに関連付けられたページ範囲を返します。

この関数は Qt 6.0 で導入されました。

setPageRanges()、QPageRangesQPrinter::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 を設定します。

page 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()も参照してください

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。