javax.print.attribute.standard

クラスNumberUp

java.lang.Object

javax.print.attribute.IntegerSyntax

javax.print.attribute.standard.NumberUp

すべての実装されたインタフェース:

Serializable, Cloneable, Attribute, DocAttribute, PrintJobAttribute, PrintRequestAttribute

public final class NumberUp
extends IntegerSyntax
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute

NumberUpは、選択された媒体の片面に印刷する出力ストリームのページ数を整数で表す印刷属性クラスです。つまり、NumberUp値がnの場合、出力ストリームのnページを選択された媒体の片面にまとめて印刷します。これを可能にするため、変形、スケーリング、および回転をプリンタ側で行う場合があります。この属性は主に出力ストリーム・ページの変形、スケーリング、および回転を制御します。

multidoc印刷ジョブ(複数のドキュメントを持つジョブ)に対するNumberUp属性の効果は、すべてのドキュメントで同じ縮小印刷数値が指定されているかどうか(または、異なるドキュメントで異なる値が指定されているかどうか)、およびMultipleDocumentHandling属性の値(通常はデフォルト)によって決定されます。

• すべてのドキュメントで縮小印刷数値nが指定されている場合、MultipleDocumentHandlingのいずれかの値が意味を持ち、プリンタの処理は、次のようにMultipleDocumentHandlingの値によって決まります。
  • SINGLE_DOCUMENT -- すべての入力ドキュメントが1つの出力ドキュメントにまとめられます。用紙には出力ドキュメントの出力ストリームがnmページまとめて印刷されます。

  • SINGLE_DOCUMENT_NEW_SHEET -- すべての入力ドキュメントが1つの出力ドキュメントにまとめられます。用紙には出力ドキュメントの出力ストリームがnページまとめて印刷されます。各入力ドキュメントの最初の印刷データは必ず新しい用紙に印刷されます。したがって、入力ドキュメントの最後の印刷データにまとめて印刷される出力ストリームのページ数はnよりも少なくなります。

  • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES -- 入力ドキュメントはそれぞれ独立して処理されます。用紙には入力ドキュメントの出力ストリームがnページまとめて印刷されます。入力ドキュメントが個別に処理されるため、各入力ドキュメントの最初の印刷データは必ず新しい用紙に印刷されます。したがって、入力ドキュメントの最後の印刷データにまとめて印刷される出力ストリームのページ数はnよりも少なくなります。

  • SEPARATE_DOCUMENTS_COLLATED_COPIES -- 入力ドキュメントはそれぞれ独立して処理されます。用紙には入力ドキュメントの出力ストリームがnページまとめて印刷されます。入力ドキュメントが個別に処理されるため、各入力ドキュメントの最初の印刷データは必ず新しい用紙に印刷されます。したがって、入力ドキュメントの最後の印刷データにまとめて印刷される出力ストリームのページ数はnよりも少なくなります。
  • SINGLE_DOCUMENT -- すべての入力ドキュメントが1つの出力ドキュメントにまとめられます。用紙には、出力ドキュメントの出力ストリームがn_iページまとめて印刷されます。ここでiは出力ドキュメント内のその時点での入力ドキュメント番号になります。次の入力ドキュメントの縮小印刷数が異なる場合は、その出力ストリームの最初のページは、新しい用紙に印刷されます。この場合、その前の用紙にまとめて印刷される出力ストリームのページ数は、指定の値よりも少なくなります。

  • SINGLE_DOCUMENT_NEW_SHEET -- すべての入力ドキュメントが1つの出力ドキュメントにまとめられます。用紙には出力ドキュメントの出力ストリームがnページまとめて印刷されます。各入力ドキュメントの最初の印刷データは必ず新しい用紙に印刷されます。したがって、入力ドキュメントの最後の印刷データにまとめて印刷される出力ストリームのページ数はnよりも少なくなります。

  • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES -- 入力ドキュメントはそれぞれ独立して処理されます。入力ドキュメントiに関して、用紙には入力ドキュメントの出力ストリームがn_iページまとめて印刷されます。入力ドキュメントが個別に処理されるため、各入力ドキュメントの最初の印刷データは必ず新しい用紙に印刷されます。したがって、入力ドキュメントの最後の印刷データにまとめて印刷される出力ストリームのページ数はn_iよりも少なくなります。

  • SEPARATE_DOCUMENTS_COLLATED_COPIES -- 入力ドキュメントはそれぞれ独立して処理されます。入力ドキュメントiに関して、用紙には入力ドキュメントの出力ストリームがn_iページまとめて印刷されます。入力ドキュメントが個別に処理されるため、各入力ドキュメントの最初の印刷データは必ず新しい用紙に印刷されます。したがって、入力ドキュメントの最後の印刷データにまとめて印刷される出力ストリームのページ数はn_iよりも少なくなります。

IPP互換性: 整数値はIPP整数値を示します。getName()によって返されるカテゴリ名はIPP属性の名前を示します。

関連項目:

直列化された形式

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
NumberUp(int value) 指定された整数値を使用して新しい縮小印刷数属性を構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
boolean	equals(Object object) この縮小印刷数属性がオブジェクトで渡されるものと一致するかどうかを返します。
Class<? extends Attribute>	getCategory() この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。
String	getName() 属性値がインスタンスとなるカテゴリの名前を返します。

クラス javax.print.attribute.IntegerSyntaxから継承されたメソッド

getValue, hashCode, toString

クラス java.lang.Objectから継承されたメソッド

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

NumberUp

public NumberUp(int value)

指定された整数値を使用して新しい縮小印刷数属性を構築します。

パラメータ:

value - 整数値。

例外:

IllegalArgumentException - 非チェック例外。valueが1より小さい場合にスローされる。

メソッドの詳細

equals

public boolean equals(Object object)

この縮小印刷数属性がオブジェクトで渡されるものと一致するかどうかを返します。次の条件がすべてtrueの場合に同等とみなされます。

1. objectがnullではない。
2. objectがNumberUpクラスのインスタンスである。
3. この縮小印刷数属性の値とobjectの値が一致する。

オーバーライド:

equals、クラス: IntegerSyntax

パラメータ:

object - 比較対象のオブジェクト。

戻り値:

objectがこの縮小印刷数属性と一致する場合はtrue、そうでない場合はfalse。

関連項目:

Object.hashCode()、HashMap

getCategory

public final Class<? extends Attribute> getCategory()

この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。

NumberUpクラスの場合、カテゴリはNumberUpクラス自身です。

定義:

getCategory、インタフェース: Attribute

戻り値:

印刷属性クラス(カテゴリ)、java.lang.Classクラスのインスタンス。

getName

public final String getName()

属性値がインスタンスとなるカテゴリの名前を返します。

NumberUpクラスの場合、カテゴリ名は"number-up"です。

定義:

getName、インタフェース: Attribute

戻り値:

属性カテゴリの名前