モジュール java.desktop
パッケージ javax.print.attribute.standard

クラスPageRanges

java.lang.Object
javax.print.attribute.SetOfIntegerSyntax
javax.print.attribute.standard.PageRanges
すべての実装されたインタフェース:
Serializable, Cloneable, Attribute, DocAttribute, PrintJobAttribute, PrintRequestAttribute
public final class PageRanges extends SetOfIntegerSyntax implements DocAttribute, PrintRequestAttribute, PrintJobAttribute
クラスPageRangesは、印刷する各文書のコピーごとにプリンタ・オブジェクトが使用する印刷ストリーム・ページのtherange(s)を識別する、一連の整数である印刷属性クラスです。 ドキュメントに存在しないものとされるページには何も印刷されません。 属性は、アプリケーションでカウントされるページ(たとえばある種のワードプロセッサ・アプリケーションのヘッダーまたはフッターに設定されるページ番号)ではなく、出力ストリームのページに関連付けられます。

多くの場合、印刷される正確なページはデバイス・ドライバで生成されるため、この属性は不要です。 ただし、すでに書式が設定されて保存されているドキュメントを印刷するときに、エンド・ユーザーがそのドキュメントの一部のページのみを要求する場合があります。 この場合、ページ範囲"n-m"が指定された場合、最初に印刷されるページはページnになります。 ドキュメントの後続のページのうち、ページm.を含むこのページまでのページがすべて印刷されます。

PageRanges属性が印刷ジョブに指定されていない場合、文書のすべてのページが印刷されます。 言い換えれば、PageRanges属性のデフォルト値は常に{{1, Integer.MAX_VALUE}}です。

マルチ・ジョブ印刷ジョブ(複数の書類を持つジョブ)に対するPageRanges属性の影響は、すべてのドキュメントが同じページ範囲を指定しているかどうか、または異なるドキュメント範囲が指定されているかどうか、MultipleDocumentHandling属性の(おそらくデフォルト)値によって異なります。

  • すべてのドキュメントに同じページ範囲が指定されている場合、MultipleDocumentHandlingのすべての値が意味を持ち、プリンタの処理が、次のとおりMultipleDocumentHandlingの値によって決まります。
    • SINGLE_DOCUMENT -- すべての入力ドキュメントは、1つの出力ドキュメントにまとめられます。 出力ドキュメントの指定されたページ範囲を印刷
    • SINGLE_DOCUMENT_NEW_SHEET -- すべての入力ドキュメントは1つの出力ドキュメントにまとめられ、各入力ドキュメントの最初の印象は常に新しいメディア・シートで開始されます。 出力ドキュメントの指定されたページ範囲を印刷
    • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES -- 個々の入力ドキュメントごとに、指定されたページ範囲が出力されます。
    • SEPARATE_DOCUMENTS_COLLATED_COPIES -- 個々の入力ドキュメントごとに、指定されたページ範囲が出力されます。
    • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES -- 個々の入力文書ごとに、指定されたページ範囲が印刷されます。
    • SEPARATE_DOCUMENTS_COLLATED_COPIES -- 個々の入力文書ごとに、指定されたページ範囲が印刷されます。

IPP互換性: PageRanges属性の正規配列形式は、IPPの「page-ranges」属性の印刷範囲の各範囲の下限と上限にそれぞれ対応します。 正規配列形式の説明は、SetOfIntegerSyntaxクラスを参照してください。 getName()によって返されるカテゴリ名はIPP属性の名前を示します。

関連項目: