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 標準で定義されている利用可能なページサイズを列挙する。これらの値はQPagedPaintDevice とQPrinter で重複している。
定義されているサイズは以下のとおりです:
定数 | 値 | 説明 |
---|---|---|
QPageSize::A0 | 3 | 841 x 1189 mm |
QPageSize::A1 | 4 | 594 x 841 mm |
QPageSize::A2 | 5 | 420 x 594 mm |
QPageSize::A3 | 6 | 297 x 420 mm |
QPageSize::A4 | 7 | 210 x 297 mm、8.26 x 11.69インチ |
QPageSize::A5 | 8 | 148 x 210 mm |
QPageSize::A6 | 9 | 105 x 148 mm |
QPageSize::A7 | 10 | 74 x 105 mm |
QPageSize::A8 | 11 | 52 x 74 mm |
QPageSize::A9 | 12 | 37 x 52 mm |
QPageSize::B0 | 14 | 1000 x 1414 mm |
QPageSize::B1 | 15 | 707 x 1000 mm |
QPageSize::B2 | 16 | 500 x 707 mm |
QPageSize::B3 | 17 | 353 x 500 mm |
QPageSize::B4 | 18 | 250 x 353 mm |
QPageSize::B5 | 19 | 176 x 250 mm、6.93 x 9.84インチ |
QPageSize::B6 | 20 | 125 x 176 mm |
QPageSize::B7 | 21 | 88 x 125 mm |
QPageSize::B8 | 22 | 62 x 88 mm |
QPageSize::B9 | 23 | 44 x 62 mm |
QPageSize::B10 | 24 | 31 x 44 mm |
QPageSize::C5E | 25 | 163 x 229 mm |
QPageSize::Comm10E | 26 | 105 x 241 mm、米国共通10封筒 |
QPageSize::DLE | 27 | 110 x 220 mm |
QPageSize::Executive | 2 | 7.5 x 10インチ、190.5 x 254 mm |
QPageSize::Folio | 28 | 210 x 330 mm |
QPageSize::Ledger | 29 | 431.8 x 279.4 mm |
QPageSize::Legal | 1 | 8.5 x 14インチ、215.9 x 355.6 mm |
QPageSize::Letter | 0 | 8.5 x 11インチ、215.9 x 279.4 mm |
QPageSize::Tabloid | 30 | 279.4 x 431.8 mm |
QPageSize::Custom | 31 | 不明、またはユーザー定義サイズ。 |
QPageSize::A10 | 13 | |
QPageSize::A3Extra | 32 | |
QPageSize::A4Extra | 33 | |
QPageSize::A4Plus | 34 | |
QPageSize::A4Small | 35 | |
QPageSize::A5Extra | 36 | |
QPageSize::B5Extra | 37 | |
QPageSize::JisB0 | 38 | |
QPageSize::JisB1 | 39 | |
QPageSize::JisB2 | 40 | |
QPageSize::JisB3 | 41 | |
QPageSize::JisB4 | 42 | |
QPageSize::JisB5 | 43 | |
QPageSize::JisB6 | 44 | , |
QPageSize::JisB7 | 45 | |
QPageSize::JisB8 | 46 | |
QPageSize::JisB9 | 47 | |
QPageSize::JisB10 | 48 | |
QPageSize::AnsiA | Letter | = レター |
QPageSize::AnsiB | Ledger | = レジャー |
QPageSize::AnsiC | 49 | |
QPageSize::AnsiD | 50 | |
QPageSize::AnsiE | 51 | |
QPageSize::LegalExtra | 52 | |
QPageSize::LetterExtra | 53 | |
QPageSize::LetterPlus | 54 | |
QPageSize::LetterSmall | 55 | |
QPageSize::TabloidExtra | 56 | |
QPageSize::ArchA | 57 | |
QPageSize::ArchB | 58 | |
QPageSize::ArchC | 59 | |
QPageSize::ArchD | 60 | |
QPageSize::ArchE | 61 | |
QPageSize::Imperial7x9 | 62 | |
QPageSize::Imperial8x10 | 63 | |
QPageSize::Imperial9x11 | 64 | |
QPageSize::Imperial9x12 | 65 | |
QPageSize::Imperial10x11 | 66 | |
QPageSize::Imperial10x13 | 67 | |
QPageSize::Imperial10x14 | 68 | |
QPageSize::Imperial12x11 | 69 | |
QPageSize::Imperial15x11 | 70 | |
QPageSize::ExecutiveStandard | 71 | |
QPageSize::Note | 72 | |
QPageSize::Quarto | 73 | |
QPageSize::Statement | 74 | |
QPageSize::SuperA | 75 | |
QPageSize::SuperB | 76 | |
QPageSize::Postcard | 77 | |
QPageSize::DoublePostcard | 78 | |
QPageSize::Prc16K | 79 | |
QPageSize::Prc32K | 80 | |
QPageSize::Prc32KBig | 81 | |
QPageSize::FanFoldUS | 82 | |
QPageSize::FanFoldGerman | 83 | |
QPageSize::FanFoldGermanLegal | 84 | |
QPageSize::EnvelopeB4 | 85 | |
QPageSize::EnvelopeB5 | 86 | |
QPageSize::EnvelopeB6 | 87 | |
QPageSize::EnvelopeC0 | 88 | |
QPageSize::EnvelopeC1 | 89 | |
QPageSize::EnvelopeC2 | 90 | |
QPageSize::EnvelopeC3 | 91 | |
QPageSize::EnvelopeC4 | 92 | |
QPageSize::EnvelopeC5 | C5E | = C5E |
QPageSize::EnvelopeC6 | 93 | |
QPageSize::EnvelopeC65 | 94 | |
QPageSize::EnvelopeC7 | 95 | |
QPageSize::EnvelopeDL | DLE | = DLE |
QPageSize::Envelope9 | 96 | |
QPageSize::Envelope10 | Comm10E | = コミュ10E |
QPageSize::Envelope11 | 97 | |
QPageSize::Envelope12 | 98 | |
QPageSize::Envelope14 | 99 | |
QPageSize::EnvelopeMonarch | 100 | |
QPageSize::EnvelopePersonal | 101 | |
QPageSize::EnvelopeChou3 | 102 | |
QPageSize::EnvelopeChou4 | 103 | |
QPageSize::EnvelopeInvite | 104 | |
QPageSize::EnvelopeItalian | 105 | |
QPageSize::EnvelopeKaku2 | 106 | |
QPageSize::EnvelopeKaku3 | 107 | |
QPageSize::EnvelopePrc1 | 108 | |
QPageSize::EnvelopePrc2 | 109 | |
QPageSize::EnvelopePrc3 | 110 | |
QPageSize::EnvelopePrc4 | 111 | |
QPageSize::EnvelopePrc5 | 112 | |
QPageSize::EnvelopePrc6 | 113 | |
QPageSize::EnvelopePrc7 | 114 | |
QPageSize::EnvelopePrc8 | 115 | |
QPageSize::EnvelopePrc9 | 116 | |
QPageSize::EnvelopePrc10 | 117 | |
QPageSize::EnvelopeYou4 | 118 | |
QPageSize::LastPageSize | EnvelopeYou4 | = EnvelopeYou4 |
歴史的な理由によりQPageSize::ExecutiveはPostscriptやWindowsの標準Executiveサイズとは異なります。
Postscriptの標準サイズQPageSize::FolioはWindowsのDMPAPER_FOLIOサイズとは異なりますので、必要に応じてPostscriptの標準サイズQPageSize::FanFoldGermanLegalを使用してください。
enum QPageSize::SizeMatchPolicy
定数 | 値 | 説明 |
---|---|---|
QPageSize::FuzzyMatch | 0 | 許容範囲内であれば、標準のページサイズに合わせる。 |
QPageSize::FuzzyOrientationMatch | 1 | 向きに関係なく、許容範囲内であれば標準のページサイズに合わせる。 |
QPageSize::ExactMatch | 2 | サイズが正確に一致する場合のみ,標準ページサイズに合わせる。 |
enum QPageSize::Unit
この列挙型は、ページサイズの測定単位を指定するのに使われる。
定数 | 値 | 説明 |
---|---|---|
QPageSize::Millimeter | 0 | |
QPageSize::Point | 1 | 1/72インチ |
QPageSize::Inch | 2 | |
QPageSize::Pica | 3 | 1/72フィート、1/6インチ、12ポイント |
QPageSize::Didot | 4 | 1/72仏インチ、0.375mm |
QPageSize::Cicero | 5 | 1/6仏インチ、12ディド、4.5mm |
メンバー関数ドキュメント
QPageSize::QPageSize()
NULLのQPageSizeを作成します。
QPageSize::QPageSize(QPageSize::PageSizeId pageSize)
標準pageSize の QPageSize を作成します。
pageSize がQPageSize::Custom の場合、結果の QPageSize は無効です。代わりにカスタムサイズのコンストラクタを使用してください。
[explicit]
QPageSize::QPageSize(const QSize &pointSize, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
一致するmatchPolicy を使用して、指定されたpointSize の QPageSize を Points 単位で作成します。
与えられたpointSize が標準のQPageSize::PageSizeId と一致する場合、そのページサイズが使用されます。matchPolicy がFuzzyMatch の場合、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 と一致する場合、そのページサイズが使われます。matchPolicy がFuzzyMatch の場合、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)
このQPageSize をother と入れ替える。この操作は非常に速く、失敗することはない。
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 を代入する。
© 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.