javax.print.attribute.standard
クラス NumberUp

java.lang.Object
  |
  +--javax.print.attribute.IntegerSyntax
        |
        +--javax.print.attribute.standard.NumberUp

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

Attribute, Cloneable, DocAttribute, PrintJobAttribute, PrintRequestAttribute, Serializable

public final class NumberUp

extends IntegerSyntax

implements DocAttribute, PrintRequestAttribute, PrintJobAttribute

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

複数ドキュメント印刷ジョブ (複数のドキュメントで構成される 1 つのジョブ) に対する NumberUp 属性の効果は、この値がすべてのドキュメントで同じに設定されているかどうかということと、MultipleDocumentHandling 属性の (既定) 値によって決定されます。

• すべてのドキュメントの縮小印刷数 n に同じ値が指定されている場合は、MultipleDocumentHandling の値が有効になり、プリンタの処理は MultipleDocumentHandling の値で決定されます。
  • SINGLE_DOCUMENT -- すべての入力ドキュメントが 1 つの出力ドキュメントにまとめられます。各媒体の印刷データには、出力ドキュメントの出力ストリームが n ページまとめて印刷されます。

  • 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	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 の値が一致する

オーバーライド:

クラス IntegerSyntax 内の equals

パラメータ:

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

戻り値:

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

getCategory

public final Class getCategory()

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

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

定義:

インタフェース Attribute 内の getCategory

戻り値:

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

getName

public final String getName()

この属性値がインスタンスであるカテゴリの名称を返します。

NumberUp クラスの場合、カテゴリ名は number-up になります。

定義:

インタフェース Attribute 内の getName

戻り値:

属性カテゴリ名