QPageSize Class

QPageSize クラスは、定義されたページ・サイズのサイズと名前を記述します。詳細...

ヘッダー #include <QPageSize>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

パブリックな型

enum PageSizeId { A0, A1, A2, A3, A4, …, LastPageSize }
enum SizeMatchPolicy { FuzzyMatch, FuzzyOrientationMatch, ExactMatch }
enum Unit { Millimeter, Point, Inch, Pica, Didot, Cicero }

パブリック関数

QPageSize()
QPageSize(QPageSize::PageSizeId pageSize)
QPageSize(const QSize &pointSize, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
QPageSize(const QSizeF &size, QPageSize::Unit units, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
QPageSize(const QPageSize &other)
~QPageSize()
QSizeF definitionSize() const
QPageSize::Unit definitionUnits() const
QPageSize::PageSizeId id() const
bool isEquivalentTo(const QPageSize &other) const
bool isValid() const
QString key() const
QString name() const
QRectF rect(QPageSize::Unit units) const
QRect rectPixels(int resolution) const
QRect rectPoints() const
QSizeF size(QPageSize::Unit units) const
QSize sizePixels(int resolution) const
QSize sizePoints() const
void swap(QPageSize &other)
int windowsId() const
QPageSize &operator=(QPageSize &&other)
QPageSize &operator=(const QPageSize &other)

静的パブリックメンバ

QSizeF definitionSize(QPageSize::PageSizeId pageSizeId)
QPageSize::Unit definitionUnits(QPageSize::PageSizeId pageSizeId)
QPageSize::PageSizeId id(int windowsId)
QPageSize::PageSizeId id(const QSize &pointSize, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
QPageSize::PageSizeId id(const QSizeF &size, QPageSize::Unit units, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
QString key(QPageSize::PageSizeId pageSizeId)
QString name(QPageSize::PageSizeId pageSizeId)
QSizeF size(QPageSize::PageSizeId pageSizeId, QPageSize::Unit units)
QSize sizePixels(QPageSize::PageSizeId pageSizeId, int resolution)
QSize sizePoints(QPageSize::PageSizeId pageSizeId)
int windowsId(QPageSize::PageSizeId pageSizeId)
bool operator!=(const QPageSize &lhs, const QPageSize &rhs)
bool operator==(const QPageSize &lhs, const QPageSize &rhs)

詳細な説明

このクラスは、Adobe Postscript PPD Standard v4.3 で定義されている標準ページサイズのセットのサポートを実装します。これは、ポイント、ミリメートル、インチでページサイズの標準セットを定義し、これらのサイズが一貫して使用されることを保証します。他のサイズ単位を使用することもできますが、計算結果となるため、必ずしも一貫性があるとは限りません。定義されたポイントサイズは常に整数で、それ以外のサイズはすべて単位の端数になります。

定義 さ れたサ イ ズはつねに幅×高 さ の順序であ り 、暗黙のページ向きはあ り ません。QPageSize::Ledger の よ う に、 幅が高 さ よ り も 大 き いページサ イ ズ を定義す る こ と も で き ますので、 幅 と 高 さ の値を比較 し てページの向 き を決定す る こ と はで き ません。

例えば、A4は標準では210mm x 297mm、8.27in x 11.69in、または595pt x 842ptと定義されています。

この単位サイズは保持され、他のすべての単位サイズ計算のベースとして使用されます。

カスタムQSize を使用して QPageSize を作成する際、QPageSize でサイズを標準ページサイズに合わせるかどうかを選択できます。デフォルトでは、QPaperSize はFuzzyMatch モードを使用します。このモードでは、指定されたページサイズが定義された標準サイズから 3 postscript ポイント以内であれば、標準ページサイズに一致させます。これをオーバーライドして完全一致のみを要求することもできますが、単位間の変換によって簡単に3ポイントが失われ、不正なページサイズになる可能性があるため、これは推奨されません。

QPageSize インスタンスは、印刷デバイスでサポートされているページサイズを照会して取得することもできます。この場合、返されるローカライズ名は、プリンタ自体によって定義されたものです。印刷デバイスは、現在のデフォルトのロケール言語をサポートしていない可能性があることに注意してください。

このクラスは、ページサイズIDをさまざまな単位サイズに変換するための便利なメソッドも提供しています。

QPagedPaintDevice およびQPdfWriterも参照してください

メンバ型ドキュメント

enum QPageSize::PageSizeId

この enum 型は、Postscript PPD 標準で定義されている利用可能なページサイズを列挙する。これらの値はQPagedPaintDeviceQPrinter で重複している。

定義されているサイズは以下のとおりです:

定数説明
QPageSize::A03841 x 1189 mm
QPageSize::A14594 x 841 mm
QPageSize::A25420 x 594 mm
QPageSize::A36297 x 420 mm
QPageSize::A47210 x 297 mm、8.26 x 11.69インチ
QPageSize::A58148 x 210 mm
QPageSize::A69105 x 148 mm
QPageSize::A71074 x 105 mm
QPageSize::A81152 x 74 mm
QPageSize::A91237 x 52 mm
QPageSize::B0141000 x 1414 mm
QPageSize::B115707 x 1000 mm
QPageSize::B216500 x 707 mm
QPageSize::B317353 x 500 mm
QPageSize::B418250 x 353 mm
QPageSize::B519176 x 250 mm、6.93 x 9.84インチ
QPageSize::B620125 x 176 mm
QPageSize::B72188 x 125 mm
QPageSize::B82262 x 88 mm
QPageSize::B92344 x 62 mm
QPageSize::B102431 x 44 mm
QPageSize::C5E25163 x 229 mm
QPageSize::Comm10E26105 x 241 mm、米国共通10封筒
QPageSize::DLE27110 x 220 mm
QPageSize::Executive27.5 x 10インチ、190.5 x 254 mm
QPageSize::Folio28210 x 330 mm
QPageSize::Ledger29431.8 x 279.4 mm
QPageSize::Legal18.5 x 14インチ、215.9 x 355.6 mm
QPageSize::Letter08.5 x 11インチ、215.9 x 279.4 mm
QPageSize::Tabloid30279.4 x 431.8 mm
QPageSize::Custom31不明、またはユーザー定義サイズ。
QPageSize::A1013
QPageSize::A3Extra32
QPageSize::A4Extra33
QPageSize::A4Plus34
QPageSize::A4Small35
QPageSize::A5Extra36
QPageSize::B5Extra37
QPageSize::JisB038
QPageSize::JisB139
QPageSize::JisB240
QPageSize::JisB341
QPageSize::JisB442
QPageSize::JisB543
QPageSize::JisB644,
QPageSize::JisB745
QPageSize::JisB846
QPageSize::JisB947
QPageSize::JisB1048
QPageSize::AnsiALetter= レター
QPageSize::AnsiBLedger= レジャー
QPageSize::AnsiC49
QPageSize::AnsiD50
QPageSize::AnsiE51
QPageSize::LegalExtra52
QPageSize::LetterExtra53
QPageSize::LetterPlus54
QPageSize::LetterSmall55
QPageSize::TabloidExtra56
QPageSize::ArchA57
QPageSize::ArchB58
QPageSize::ArchC59
QPageSize::ArchD60
QPageSize::ArchE61
QPageSize::Imperial7x962
QPageSize::Imperial8x1063
QPageSize::Imperial9x1164
QPageSize::Imperial9x1265
QPageSize::Imperial10x1166
QPageSize::Imperial10x1367
QPageSize::Imperial10x1468
QPageSize::Imperial12x1169
QPageSize::Imperial15x1170
QPageSize::ExecutiveStandard71
QPageSize::Note72
QPageSize::Quarto73
QPageSize::Statement74
QPageSize::SuperA75
QPageSize::SuperB76
QPageSize::Postcard77
QPageSize::DoublePostcard78
QPageSize::Prc16K79
QPageSize::Prc32K80
QPageSize::Prc32KBig81
QPageSize::FanFoldUS82
QPageSize::FanFoldGerman83
QPageSize::FanFoldGermanLegal84
QPageSize::EnvelopeB485
QPageSize::EnvelopeB586
QPageSize::EnvelopeB687
QPageSize::EnvelopeC088
QPageSize::EnvelopeC189
QPageSize::EnvelopeC290
QPageSize::EnvelopeC391
QPageSize::EnvelopeC492
QPageSize::EnvelopeC5C5E= C5E
QPageSize::EnvelopeC693
QPageSize::EnvelopeC6594
QPageSize::EnvelopeC795
QPageSize::EnvelopeDLDLE= DLE
QPageSize::Envelope996
QPageSize::Envelope10Comm10E= コミュ10E
QPageSize::Envelope1197
QPageSize::Envelope1298
QPageSize::Envelope1499
QPageSize::EnvelopeMonarch100
QPageSize::EnvelopePersonal101
QPageSize::EnvelopeChou3102
QPageSize::EnvelopeChou4103
QPageSize::EnvelopeInvite104
QPageSize::EnvelopeItalian105
QPageSize::EnvelopeKaku2106
QPageSize::EnvelopeKaku3107
QPageSize::EnvelopePrc1108
QPageSize::EnvelopePrc2109
QPageSize::EnvelopePrc3110
QPageSize::EnvelopePrc4111
QPageSize::EnvelopePrc5112
QPageSize::EnvelopePrc6113
QPageSize::EnvelopePrc7114
QPageSize::EnvelopePrc8115
QPageSize::EnvelopePrc9116
QPageSize::EnvelopePrc10117
QPageSize::EnvelopeYou4118
QPageSize::LastPageSizeEnvelopeYou4= EnvelopeYou4

歴史的な理由によりQPageSize::ExecutiveはPostscriptやWindowsの標準Executiveサイズとは異なります。

Postscriptの標準サイズQPageSize::FolioはWindowsのDMPAPER_FOLIOサイズとは異なりますので、必要に応じてPostscriptの標準サイズQPageSize::FanFoldGermanLegalを使用してください。

enum QPageSize::SizeMatchPolicy

定数説明
QPageSize::FuzzyMatch0許容範囲内であれば、標準のページサイズに合わせる。
QPageSize::FuzzyOrientationMatch1向きに関係なく、許容範囲内であれば標準のページサイズに合わせる。
QPageSize::ExactMatch2サイズが正確に一致する場合のみ,標準ページサイズに合わせる。

enum QPageSize::Unit

この列挙型は、ページサイズの測定単位を指定するのに使われる。

定数説明
QPageSize::Millimeter0
QPageSize::Point11/72インチ
QPageSize::Inch2
QPageSize::Pica31/72フィート、1/6インチ、12ポイント
QPageSize::Didot41/72仏インチ、0.375mm
QPageSize::Cicero51/6仏インチ、12ディド、4.5mm

メンバー関数ドキュメント

QPageSize::QPageSize()

NULLのQPageSizeを作成します。

QPageSize::QPageSize(QPageSize::PageSizeId pageSize)

標準pageSize の QPageSize を作成します。

pageSizeQPageSize::Custom の場合、結果の QPageSize は無効です。代わりにカスタムサイズのコンストラクタを使用してください。

[explicit] QPageSize::QPageSize(const QSize &pointSize, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

一致するmatchPolicy を使用して、指定されたpointSize の QPageSize を Points 単位で作成します。

与えられたpointSize が標準のQPageSize::PageSizeId と一致する場合、そのページサイズが使用されます。matchPolicyFuzzyMatch の場合、pointSize が標準サイズに調整される可能性があることに注意してください。これを防ぐには、matchPolicy の代わりにExactMatch を使ってください。

与えられたpointSize が標準のQPageSize::PageSizeId でない場合、QPageSize::Custom サイズが作成されます。

name が NULL の場合は、標準のローカライズ名が使われます。カスタムページサイズの場合は、"Custom (width x height) "という形式のカスタム名が作成されます。

matchPolicy のデフォルトはFuzzyMatch です。

[explicit] QPageSize::QPageSize(const QSizeF &size, QPageSize::Unit units, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

与えられたsize のカスタムページをunits で作成する。

与えられたsize が標準のQPageSize::PageSizeId と一致する場合、そのページサイズが使われます。matchPolicyFuzzyMatch の場合、size が標準サイズに調整される可能性があることに注意してください。これを防ぐには、matchPolicy の代わりにExactMatch を使ってください。

与えられたsize が標準のQPageSize::PageSizeId でない場合、QPageSize::Custom サイズが作成されます。元のユニットサイズは保持され、他のすべてのユニットサイズ計算のベースとして使用されます。

name が NULL の場合、"Custom (width x height)" という形式でカスタム名が作成され、サイズは指定された単位で表されます。

QPageSize::QPageSize(const QPageSize &other)

コピーコンストラクタ。other をこのコンストラクタにコピーする。

[noexcept] QPageSize::~QPageSize()

ページを破壊する。

QSizeF QPageSize::definitionSize() const

ページサイズの定義サイズを返します。

すなわち、ISO A4 はミリメートルで定義され、ANSI Letter はインチで定義されます。

カ ス タ ムページサ イ ズの場合、 こ れはページサ イ ズオブジ ェ ク ト を作成す る ために用い ら れた元のサ イ ズ と な り ます。

QPageSize が無効な場合、QSizeF も無効になります。

definitionUnits()も参照

[static] QSizeF QPageSize::definitionSize(QPageSize::PageSizeId pageSizeId)

標準pageSizeId の定義サイズを返す。

定義単位を取得するには、QPageSize::definitionUnits() を呼び出す。

QPageSize::Unit QPageSize::definitionUnits() const

ページサイズの定義単位を返します。

すなわち、ISO A4 はミリメートルで定義され、ANSI Letter はインチで定義されます。

カ ス タ ムページサ イ ズの場合、 こ れはページサ イ ズオブジ ェ ク ト を作成す る ために用い ら れた元の単位にな り ます。

QPageSize が無効な場合、QPageSize::Unit も無効になります。

definitionSize()も参照

[static] QPageSize::Unit QPageSize::definitionUnits(QPageSize::PageSizeId pageSizeId)

標準pageSizeId の定義単位を返す。

定義サイズを取得するには、QPageSize::definitionSize() を呼び出す。

QPageSize::PageSizeId QPageSize::id() const

ページの標準QPageSize::PageSizeId 、またはQPageSize::Custom を返す。

QPageSize が無効な場合、IDはQPageSize::Custom になる。

[static] QPageSize::PageSizeId QPageSize::id(int windowsId)

与えられたWindows DMPAPER列挙値windowsId に対するPageSizeId を返す。

一致するPageSizeId がない場合は、QPageSize::Custom が返される。

[static] QPageSize::PageSizeId QPageSize::id(const QSize &pointSize, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

与えられたmatchPolicy を用いて、与えられたpointSize の標準QPageSize::PageSizeId をポイントで返す。

FuzzyMatch を使用する場合、返されるPageSizeId のポイント・サイズは、渡されたpointSize と正確に一致しない可能性がある。計算で使用する前に、返されたPageSizeId を使用してQPageSize::sizePoints() を呼び出し、PageSizeId の実際のポイント・サイズを調べる必要がある。

[static] QPageSize::PageSizeId QPageSize::id(const QSizeF &size, QPageSize::Unit units, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

与えられたsize の標準QPageSize::PageSizeId を、与えられたmatchPolicy を使ってunits で返す。

FuzzyMatch を使用する場合、返されるPageSizeId の単位サイズは、渡されたsize と正確に一致しない可能性があります。計算で使用する前に、返されたPageSizeId を使用してQPageSize::size() を呼び出し、PageSizeId の実際の単位サイズを調べる必要がある。

bool QPageSize::isEquivalentTo(const QPageSize &other) const

このページがother ページと等価である場合、つまり name などの他の属性に関係なく、ページのサイズが同じである場合にtrue を返す。

bool QPageSize::isValid() const

こ のページサ イ ズ が有効な と き はtrue を返す。

無効なPageSizeId で作成された場合、あるいは負数または無効なQSize またはQSizeF で作成された場合、あるいは null コンストラクタの場合、ページサイズは無効である可能性があります。

QString QPageSize::key() const

ページサイズの一意なキーを返す。

デフ ォル ト では、 こ れはページサ イ ズの PPD 標準 mediaOption キーワー ド 、 または PPD カ ス タ ム形式キーワー ド です。QPageSize インスタンスが印刷デバイスから取得された場合、これは印刷デバイスが提供するキーになり、標準キーとは異なる可能性があります。

QPageSize が無効な場合、キーは空文字列になる。

このキーは決してエンドユーザーに見せてはならない。人間が読める名前にするには、name() を使用する。

name()も参照の こと。

[static] QString QPageSize::key(QPageSize::PageSizeId pageSizeId)

標準pageSizeId の PPD mediaOption キーワードを返す。

QPageSize が無効な場合、キーは空になる。

QString QPageSize::name() const

ページサイズをローカライズした人間が読める名前を返す。

QPageSize インスタンスが印刷デバイスから取得された場合、使用される名前は印刷デバイスが提供する名前です。印刷デバイスが現在のデフォルトロケール言語をサポートしていない可能性があることに注意。

QPageSize が無効な場合、名前は空文字列になる。

[static] QString QPageSize::name(QPageSize::PageSizeId pageSizeId)

pageSizeId 標準のローカライズされた名前を返す。

QPageSize が無効な場合、名前は空になります。

QRectF QPageSize::rect(QPageSize::Unit units) const

必要なunits のページ矩形を返す。

QPageSize が無効な場合はQRect も無効となる。

QRect QPageSize::rectPixels(int resolution) const

与えられたresolution のページ矩形を Device Pixels で返す。

QPageSize が無効な場合はQRect も無効となる。

QRect QPageSize::rectPoints() const

ページの矩形をポストスクリプトポイント(1/72インチ)で返す。

QPageSize が無効な場合はQRect も無効となる。

QSizeF QPageSize::size(QPageSize::Unit units) const

必要なページのサイズをunits で返す。

QPageSize が無効な場合、QSizeF も無効となる。

[static] QSizeF QPageSize::size(QPageSize::PageSizeId pageSizeId, QPageSize::Unit units)

要求されたunits の標準pageSizeId のサイズを返す。

QSize QPageSize::sizePixels(int resolution) const

与えられたresolution におけるページのサイズを Device Pixels で返す。

QPageSize が無効な場合はQSize も無効となる。

[static] QSize QPageSize::sizePixels(QPageSize::PageSizeId pageSizeId, int resolution)

与えられたresolution の標準pageSizeId のサイズをデバイスピクセル単位で返す。

QSize QPageSize::sizePoints() const

ページのサイズをポストスクリプトポイント(1/72インチ)で返す。

QPageSize が無効な場合、QSize も無効となる。

[static] QSize QPageSize::sizePoints(QPageSize::PageSizeId pageSizeId)

標準pageSizeId のサイズを Points で返す。

[noexcept] void QPageSize::swap(QPageSize &other)

このQPageSizeother と入れ替える。この操作は非常に速く、失敗することはない。

int QPageSize::windowsId() const

ページサイズのWindows DMPAPER列挙値を返す。

すべての有効なPPDページサイズにWindowsと同等のものがあるわけではなく、その場合は0が返される。

QPageSize が無効な場合、Windows ID は 0 になる。

id()も参照

[static] int QPageSize::windowsId(QPageSize::PageSizeId pageSizeId)

pageSizeId 標準のWindows DMPAPER列挙値を返す。

すべての有効なPPDページ・サイズがWindowsに相当するわけではありません。

[noexcept] QPageSize &QPageSize::operator=(QPageSize &&other)

Move-このQPageSize インスタンスにother を割り当て、管理ポインタの所有権をこのインスタンスに移す。

QPageSize &QPageSize::operator=(const QPageSize &other)

代入演算子。other を代入する。

関連する非会員

bool operator!=(const QPageSize &lhs, const QPageSize &rhs)

ページ・サイズlhs がページ・サイズrhs と等しくない場合、すなわちページ・サイズが異なる属性を持つ場合、true を返す。現在の属性はsizeとnameです。

bool operator==(const QPageSize &lhs, const QPageSize &rhs)

ページ・サイズlhs がページ・サイズrhs と等しい場合、すなわちページ・サイズが同じ属性を持つ場合、true を返す。現在の属性はsizeとnameです。

© 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.