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 |
- 継承メンバを含む全メンバ一覧
- QPagedPaintDeviceはペイントクラスの一部です。
パブリック型
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 を設定します。
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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。