javax.print.attribute.standard

クラスMultipleDocumentHandling

java.lang.Object

javax.print.attribute.EnumSyntax

javax.print.attribute.standard.MultipleDocumentHandling

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

Serializable, Cloneable, Attribute, PrintJobAttribute, PrintRequestAttribute

public class MultipleDocumentHandling
extends EnumSyntax
implements PrintRequestAttribute, PrintJobAttribute

MultipleDocumentHandlingは、仕上げ処理、および1つ以上の出力ストリーム・ページの印刷データと用紙上での配置方法を制御する値を列挙して示す印刷属性クラスです。Copies属性の値が1より大きいときには、ドキュメント処理で生成される複数の印刷物が生成される順序もMultipleDocumentHandlingで制御します。この属性は2つ以上の独立したドキュメントで構成される複数ドキュメント印刷ジョブだけに関連します。

簡単に言うと、MultipleDocumentHandlingは複数ドキュメント印刷ジョブで送信される複数の(電子的な)入力ドキュメントと(物理的な)出力ドキュメントの関係、または複数ドキュメント印刷ジョブで生成されるドキュメントの関係を決定します。可能性は2つあります。

• 複数の入力ドキュメントを1つの出力ドキュメントにまとめます。仕上げ処理(Finishings)をこの1つの出力ドキュメントに対して実行。Copies属性は、生成するこの単独の出力ドキュメントに含まれる部数を示す。MultipleDocumentHandlingに指定する値SINGLE_DOCUMENTとSINGLE_DOCUMENT_NEW_SHEETで処理内容を変えることができる。

• 複数の入力ドキュメントは複数の出力ドキュメントとして出力されます。仕上げ処理(Finishings)を各出力ドキュメントに対して個別に実行。Copies属性は、生成する各出力ドキュメントの総数を示す。MultipleDocumentHandlingに指定する値SEPARATE_DOCUMENTS_UNCOLLATED_COPIESとSEPARATE_DOCUMENTS_COLLATED_COPIESで処理内容を変えることができる。

次の説明では、「a」がドキュメント・データのインスタンスを表し、ドキュメント「a」のデータ処理結果である印刷単位は「a(*)」で表されます。

標準MultipleDocumentHandling値を次に挙げます。

• SINGLE_DOCUMENT。印刷ジョブが複数ドキュメント(これらを仮にa、bとする)で構成される場合、すべてのドキュメント・データ(aおよびb)の処理結果全体を1つの印刷単位として扱う必要がある。つまり、a(*),b(*)の連結に対して仕上げ処理を実行。各ドキュメント・インスタンスのデータを新しい出力ストリーム・ページとして強制的に書式設定したり、新しい印刷データを強制的に改ページして印刷することはできない。部数が複数の場合は、ドキュメント・データ処理後の用紙セットの順序はa(*),b(*),a(*),b(*),...のようになり、各部(a(*),b(*))で新しい用紙から印刷を開始する必要がある。

• SEPARATE_DOCUMENTS_UNCOLLATED_COPIES。印刷ジョブが複数ドキュメント(これらを仮にaおよびbとする)で構成される場合、各ドキュメント・インスタンスのデータ処理結果を単独の印刷単位として扱う。つまり、a(*)とb(*)の各セットに対して個別に仕上げ処理を実行。単独のドキュメントのデータ処理結果として得られる1部のデータを印刷開始するときに改ページを行う。部数が複数の場合、ドキュメント・データ処理後の用紙セットの順序はa(*),a(*),...,b(*),b(*)...である必要がある。

• SEPARATE_DOCUMENTS_COLLATED_COPIES。印刷ジョブが複数ドキュメント(これらを仮にaおよびbとする)で構成される場合、各ドキュメント・インスタンスのデータ処理結果を単独の印刷単位として扱う。つまり、a(*)とb(*)の各セットに対して個別に仕上げ処理を実行。単独のドキュメントのデータ処理結果として得られる1部のデータを印刷開始するときに改ページを行う。部数が複数の場合、ドキュメント・データ処理後の用紙セットの順序はa(*),b(*),a(*),b(*),...である必要がある。

• SINGLE_DOCUMENT_NEW_SHEET。ジョブの各ドキュメント・インスタンスの最初のデータ印刷前に改ページを行う必要がある点を除いて、SINGLE_DOCUMENTと同じ。各ドキュメントが新しい用紙から開始されるので、複数のドキュメントを1つに綴じることができる

SINGLE_DOCUMENTは出力ストリーム・ページの順序の面ではSEPARATE_DOCUMENTS_COLLATED_COPIESと同じですが、用紙の開始位置が異なります。SINGLE_DOCUMENTの場合、これまでのジョブで生成されているページ数が奇数の場合は次のドキュメントの最初のページが用紙の裏側に印刷されますが、SEPARATE_DOCUMENTS_COLLATED_COPIESでは新しいドキュメントまたは新しい部は必ず新しい用紙に印刷されます。

さらに、Finishings属性にSTAPLEが指定された場合は次のようになります。

• SINGLE_DOCUMENTでは、aとbが1つのドキュメントとしてホッチキスでまとめられる。改ページについては考慮しない。

• SINGLE_DOCUMENT_NEW_SHEETでは、aとbが1つのドキュメントとしてホッチキスでまとめられる。bの印刷前に改ページを行う。

• SEPARATE_DOCUMENTS_UNCOLLATED_COPIESとSEPARATE_DOCUMENTS_COLLATED_COPIESでは、aとbは別々にホッチキスでまとめられる。

注: これらの値を使用しても、nページが同じドキュメントのn+1ページの前に複数印刷される場合は、丁合いを行わないで印刷することはできません。これを指定するには、SheetCollate属性を参照してください。

IPP互換性: getName()によって返されるカテゴリ名はIPP属性の名前です。列挙の整数値はIPP列挙型値です。toString()メソッドは、属性値のIPP文字列表現を返します。

関連項目:

Copies, Finishings, NumberUp, PageRanges, SheetCollate, Sides, 直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
static MultipleDocumentHandling	SEPARATE_DOCUMENTS_COLLATED_COPIES 複数ドキュメント、丁合いあり -- 前述の詳細を参照。
static MultipleDocumentHandling	SEPARATE_DOCUMENTS_UNCOLLATED_COPIES 複数ドキュメント、丁合いなし -- 前述の詳細を参照。
static MultipleDocumentHandling	SINGLE_DOCUMENT 単独ドキュメント -- 前述の詳細を参照。
static MultipleDocumentHandling	SINGLE_DOCUMENT_NEW_SHEET 単独ドキュメント、改ページ印刷 -- 前述の詳細を参照。

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

コンストラクタ

修飾子	コンストラクタと説明
protected	MultipleDocumentHandling(int value) 指定された整数値を使用して新しい複数ドキュメント処理列挙値を構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
Class<? extends Attribute>	getCategory() この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。
protected EnumSyntax[]	getEnumValueTable() MultipleDocumentHandlingクラスの列挙値テーブルを返します。
String	getName() 属性値がインスタンスとなるカテゴリの名前を返します。
protected String[]	getStringTable() MultipleDocumentHandlingクラスの文字列テーブルを返します。

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

clone, getOffset, getValue, hashCode, readResolve, toString

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

equals, finalize, getClass, notify, notifyAll, wait, wait, wait

フィールドの詳細

SINGLE_DOCUMENT

public static final MultipleDocumentHandling SINGLE_DOCUMENT

単独ドキュメント -- 前述の詳細を参照。

SEPARATE_DOCUMENTS_UNCOLLATED_COPIES

public static final MultipleDocumentHandling SEPARATE_DOCUMENTS_UNCOLLATED_COPIES

複数ドキュメント、丁合いなし -- 前述の詳細を参照。

SEPARATE_DOCUMENTS_COLLATED_COPIES

public static final MultipleDocumentHandling SEPARATE_DOCUMENTS_COLLATED_COPIES

複数ドキュメント、丁合いあり -- 前述の詳細を参照。

SINGLE_DOCUMENT_NEW_SHEET

public static final MultipleDocumentHandling SINGLE_DOCUMENT_NEW_SHEET

単独ドキュメント、改ページ印刷 -- 前述の詳細を参照。

コンストラクタの詳細

MultipleDocumentHandling

protected MultipleDocumentHandling(int value)

指定された整数値を使用して新しい複数ドキュメント処理列挙値を構築します。

パラメータ:

value - 整数値。

メソッドの詳細

getStringTable

protected String[] getStringTable()

MultipleDocumentHandlingクラスの文字列テーブルを返します。

オーバーライド:

getStringTable、クラス: EnumSyntax

戻り値:

文字列テーブル

getEnumValueTable

protected EnumSyntax[] getEnumValueTable()

MultipleDocumentHandlingクラスの列挙値テーブルを返します。

オーバーライド:

getEnumValueTable、クラス: EnumSyntax

戻り値:

値テーブル

getCategory

public final Class<? extends Attribute> getCategory()

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

MultipleDocumentHandlingクラス、およびベンダー定義の任意のサブクラスでは、カテゴリはMultipleDocumentHandlingクラス自身になります。

定義:

getCategory、インタフェース: Attribute

戻り値:

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

getName

public final String getName()

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

MultipleDocumentHandlingクラスおよびベンダー定義のサブクラスの場合、カテゴリ名は"multiple-document-handling"です。

定義:

getName、インタフェース: Attribute

戻り値:

属性カテゴリの名前