モジュール java.desktop

パッケージ 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ページを選択された媒体の片面にまとめて印刷します。 これを可能にするため、変形、スケーリング、および回転をプリンタ側で行う場合があります。 この属性は主に出力ストリーム・ページの変形、スケーリング、および回転を制御します。

マルチ・ジョブ印刷ジョブ(複数の書類を持つジョブ)での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)	この縮小印刷数属性がオブジェクトで渡されるものと一致するかどうかを返します。
final Class<? extends Attribute>	getCategory()	この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。
final 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 objectがこの番号up属性に相当する場合はfalse、それ以外の場合はfalse

関連項目:

• Object.hashCode()
• HashMap

getCategory

public final Class<? extends Attribute> getCategory()

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

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

定義:

getCategory、インタフェースAttribute

戻り値:

印刷属性クラス(category)、クラスjava.lang.Classのインスタンス

getName

public final String getName()

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

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

定義:

getName、インタフェースAttribute

戻り値:

属性カテゴリ名