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
は、印刷される各文書の各コピーに対してPrinterオブジェクトが使用する印刷ストリーム・ページの範囲を識別する印刷属性クラスであり、整数のセットです。 ドキュメントに存在しないものとされるページには何も印刷されません。 属性は、アプリケーションでカウントされるページ(たとえばある種のワードプロセッサ・アプリケーションのヘッダーまたはフッターに設定されるページ番号)ではなく、出力ストリームのページに関連付けられます。
多くの場合、印刷される正確なページはデバイス・ドライバで生成されるため、この属性は不要です。 ただし、すでに書式が設定されて保存されているドキュメントを印刷するときに、エンド・ユーザーがそのドキュメントの一部のページのみを要求する場合があります。 この場合、ページ範囲"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属性の名前を示します。
- 関連項目:
-
コンストラクタのサマリー
コンストラクタ説明PageRanges
(int member) 単独の整数で構成される新しいページ範囲属性を構築します。PageRanges
(int[][] members) 指定されたメンバーを使用して、新しいページ範囲属性を構築します。PageRanges
(int lowerBound, int upperBound) 単独の整数範囲で構成される新しいページ範囲属性を構築します。PageRanges
(String members) 文字列形式で指定されたメンバーを使用して、新しいページ範囲属性を構築します。 -
メソッドのサマリー
クラス javax.print.attribute.SetOfIntegerSyntaxで宣言されたメソッド
contains, contains, getMembers, hashCode, next, toString
-
コンストラクタの詳細
-
PageRanges
public PageRanges(int[][] members) 指定されたメンバーを使用して、新しいページ範囲属性を構築します。 メンバーは「配列形式」で指定されます。配列形式の説明は、SetOfIntegerSyntax
クラスを参照してください。- パラメータ:
members
- メンバーを配列形式で設定- 例外:
NullPointerException
-members
がnull
の場合、またはmembers
の要素がnull
の場合IllegalArgumentException
-members
のいずれかの要素が長さ1または長さ2の配列でない場合。 また、members
が長さゼロの配列である場合、またはセットのメンバーが1未満の場合。
-
PageRanges
public PageRanges(String members) 文字列形式で指定されたメンバーを使用して、新しいページ範囲属性を構築します。 構文の説明については、SetOfIntegerSyntax
クラスを参照してください。- パラメータ:
members
- メンバーを文字列形式で設定- 例外:
NullPointerException
-members
がnull
の場合、またはmembers
の要素がnull
の場合IllegalArgumentException
-members
が正しい構文に従わない場合。 また、構築された整数の集合が長さゼロの配列であるか、または集合のメンバーが1より小さい場合。
-
PageRanges
public PageRanges(int member) 単独の整数で構成される新しいページ範囲属性を構築します。 1ページだけが印刷されます。- パラメータ:
member
- セット・メンバー- 例外:
IllegalArgumentException
-member < 1
の場合
-
PageRanges
public PageRanges(int lowerBound, int upperBound) 単独の整数範囲で構成される新しいページ範囲属性を構築します。 この範囲のページだけが印刷されます。- パラメータ:
lowerBound
- 範囲の下限upperBound
- 範囲の上限- 例外:
IllegalArgumentException
-null
の範囲が指定されている場合、またはlowerBound
の範囲が1未満のlowerBound
で指定されている場合
-
-
メソッドの詳細
-
equals
public boolean equals(Object object) このページ範囲属性がオブジェクトで渡されるものと同等かどうかを返します。 次の条件がすべてtrueの場合に同等とみなされます。object
はnull
ではありません。object
はPageRanges
クラスのインスタンスです。- このページ範囲属性のメンバーと
object
のメンバーが一致する。
- オーバーライド:
equals
、クラスSetOfIntegerSyntax
- パラメータ:
object
- 比較するObject
- 戻り値:
true
object
がこのページ範囲属性に相当する場合、それ以外の場合はfalse
- 関連項目:
-
getCategory
この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。クラス
PageRanges
の場合、カテゴリはクラスPageRanges
自体です。- 定義:
getCategory
、インタフェースAttribute
- 戻り値:
- 印刷属性クラス(category)、クラス
java.lang.Class
のインスタンス
-
getName
public final String getName()属性値がインスタンスとなるカテゴリの名前を返します。クラス
PageRanges
の場合、カテゴリ名は"page-ranges"
です。
-