javax.print.attribute.SetOfIntegerSyntax
javax.print.attribute.standard.PageRanges
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
java.lang.Object
public final class PageRanges
PageRanges は、プリンタオブジェクトが印刷する各ドキュメントに使用する、出力ストリームの範囲を整数値のセットで表す印刷属性クラスです。ドキュメントに存在しないものとされるページには何も印刷されません。属性は、たとえばある種のワードプロセッサアプリケーションのヘッダーまたはフッターに設定される、アプリケーションでカウントされるページではなく、「出力ストリーム」のページに関連付けられます。
多くの場合、印刷される正確なページはデバイスドライバで生成されるため、この属性は不要です。ただし、すでに書式が設定されて保存されているドキュメントを印刷する時に、エンドユーザーがそのドキュメントの一部のページだけを要求する場合があります。この場合にページ範囲として n-m が指定されると、n ページから m ページまでが印刷されます。
PageRanges 属性が印刷ジョブに指定されていない場合、ドキュメントのすべてのページが印刷されます。つまり、PageRanges 属性のデフォルト値は {{1, Integer.MAX_VALUE}} になります。
複数ドキュメント印刷ジョブ (複数のドキュメントで構成される 1 つのジョブ) に対する PageRanges 属性の効果は、この値がすべてのドキュメントで同じに設定されているかどうか (または、異なるドキュメントで異なった値が設定されているかどうか) ということと、MultipleDocumentHandling 属性の (既定) 値によって決定されます。
MultipleDocumentHandling のすべての値が意味を持ち、プリンタの処理が、次のとおり MultipleDocumentHandling の値によって決まります。
IPP 互換性: PageRanges 属性の正規配列形式は、IPP の page-ranges 属性の印刷範囲の各範囲の下限と上限にそれぞれ対応します。正規配列形式の説明は
PageRanges クラスの場合、カテゴリは PageRanges クラス自身です。
PageRanges クラスの場合、カテゴリ名は
Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。SetOfIntegerSyntax クラスを参照してください。getName() によって返されるカテゴリ名は IPP 属性名を示します。
コンストラクタの概要
PageRanges(int member)
単独の整数で構成される新しいページ範囲属性を構築します。
PageRanges(int[][] members)
指定されたメンバーを使用して、新しいページ範囲属性を構築します。
PageRanges(int lowerBound,
int upperBound)
単独の整数範囲で構成される新しいページ範囲属性を構築します。
PageRanges(String members)
文字列形式で指定されたメンバーを使用して、新しいページ範囲属性を構築します。
メソッドの概要
booleanequals(Object object)
このページ範囲属性がオブジェクトで渡されるものと同等かどうかを返します。
Class<? extends Attribute>getCategory()
この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。
StringgetName()
属性値がインスタンスとなるカテゴリの名前を返します。
クラス javax.print.attribute.SetOfIntegerSyntax から継承されたメソッド
contains, contains, getMembers, hashCode, next, toString
クラス java.lang.Object から継承されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
コンストラクタの詳細
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)
member - セットのメンバー
IllegalArgumentException - 未確認の例外。member が 1 より小さい場合
PageRanges
public PageRanges(int lowerBound,
int upperBound)
lowerBound - 範囲の下限upperBound - 範囲の上限
IllegalArgumentException - 未確認の例外。null 範囲が指定されている場合、 または 1 より小さい lowerBound で null でない範囲が指定されている場合、スローされる 1.
メソッドの詳細
equals
public boolean equals(Object object)
object が null ではない
object が PageRanges クラスのインスタンスである
object のメンバーが一致する
SetOfIntegerSyntax 内の equals
object - 比較対象のオブジェクト
object がこのページ範囲属性と一致する場合は true、 そうでない場合は falseObject.hashCode(),
Hashtable
getCategory
public final Class<? extends Attribute> getCategory()
Attribute 内の getCategory
java.lang.Class クラスのインスタンス
getName
public final String getName()
page-ranges になります。
概要
パッケージ
クラス
使用
階層ツリー
非推奨 API
索引
ヘルプ
JavaTM Platform
Standard Ed. 6
前のクラス
次のクラス
フレームあり
フレームなし
概要: 入れ子 | フィールド | コンストラクタ | メソッド
詳細: フィールド | コンストラクタ | メソッド
バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。