java.awt

クラス JobAttributes

java.lang.Object

java.awt.JobAttributes

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

Cloneable

public final class JobAttributes
extends Object
implements Cloneable

印刷ジョブを制御する属性セットです。

このクラスのインスタンスは、このインスタンスを使用している各印刷ジョブの、コピーの部数、デフォルトの選択、出力先、印刷のダイアログ、ファイル名とプリンタ名、ページ範囲、複数のドキュメント処理 (照合を含む)、デュープレックスのような複数ページの組み付けなどを制御します。属性名は、可能な場合 Internet Printing Protocol (IPP) 1.1 に準拠しています。属性値は可能な場合、部分的に Internet Printing Protocol (IPP) 1.1 に準拠しています。

内部クラス型をとるメソッドを使用するには、その内部クラスの定数フィールドに対する参照を渡します。クライアントコードは、このクラスが public コンストラクタを持たないため、内部クラス型の新規インスタンスを作成できません。たとえば、印刷のダイアログ型を共通プラットフォームの Pure Java 印刷ダイアログに設定するには、次のコードを使用します。

 import java.awt.JobAttributes;

 public class PureJavaPrintDialogExample {
     public void setPureJavaPrintDialog(JobAttributes jobAttributes) {
         jobAttributes.setDialog(JobAttributes.DialogType.COMMON);
     }
 }
 

attributeName のデフォルト値をサポートするどの IPP 属性にも、対応する setattributeNameToDefault メソッドがあります。デフォルト値のフィールドは提供されていません。

導入されたバージョン:

1.3

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
static class	JobAttributes.DefaultSelectionType 使用可能なデフォルト選択状態の型保証された列挙です。
static class	JobAttributes.DestinationType 使用可能なジョブ出力先の型保証された列挙です。
static class	JobAttributes.DialogType ユーザーに表示する使用可能なダイアログの型保証された列挙です。
static class	JobAttributes.MultipleDocumentHandlingType 使用可能な複数のコピー処理の状態の型保証された列挙です。
static class	JobAttributes.SidesType 使用可能な複数ページの組み付けの型保証された列挙です。

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

コンストラクタ

コンストラクタと説明
JobAttributes() すべての属性にデフォルト値を使用して、JobAttributes インスタンスを構築します。
JobAttributes(int copies, JobAttributes.DefaultSelectionType defaultSelection, JobAttributes.DestinationType destination, JobAttributes.DialogType dialog, String fileName, int maxPage, int minPage, JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling, int[][] pageRanges, String printer, JobAttributes.SidesType sides) すべての属性に指定された値を使用して、JobAttributes インスタンスを構築します。
JobAttributes(JobAttributes obj) 指定された JobAttributes のコピーである JobAttributes インスタンスを構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
Object	clone() この JobAttributes のコピーを作成して返します。
boolean	equals(Object obj) 2 つの JobAttributes が同じであるかどうかを判定します。
int	getCopies() これらの属性を使うジョブに対して、アプリケーションが描画する必要のあるコピーの数を返します。
JobAttributes.DefaultSelectionType	getDefaultSelection() これらの属性を使用するジョブについて、アプリケーションが、すべてのページ、getPageRanges の戻り値によって指定された範囲、現在の選択のいずれを出力するかを指定します。
JobAttributes.DestinationType	getDestination() これらの属性を使用するジョブについて、プリンタまたはファイルのどちらに出力するかを指定します。
JobAttributes.DialogType	getDialog() これらの属性を使用するジョブについて、ユーザーが印刷の設定を変更する印刷のダイアログを見る必要があるか、そしてどのタイプの印刷のダイアログが表示されるべきかを返します。
String	getFileName() これらの属性を使うジョブに対して、出力ファイルの名前を指定します。
int	getFromPage() これらの属性を使用するジョブについてページの範囲を印刷する場合、印刷対象の最初のページを返します。
int	getMaxPage() これらの属性を使用するジョブについて、ユーザーが指定できる最大値を印刷対象の最終ページとして指定します。
int	getMinPage() これらの属性を使用するジョブについて、ユーザーが指定できる最小値を印刷対象の開始ページとして指定します。
JobAttributes.MultipleDocumentHandlingType	getMultipleDocumentHandling() これらの属性を使用するジョブについて、複数のコピーの処理 (照合を含む) を指定します。
int[][]	getPageRanges() これらの属性を使用するジョブについてページの範囲を印刷する場合、印刷対象のページの範囲を指定します。
String	getPrinter() これらの属性を使用するジョブについて、出力先プリンタを返します。
JobAttributes.SidesType	getSides() これらの属性を使用するジョブについて、印刷メディアのサイドに連続したページが組み付けられる方法を返します。
int	getToPage() これらの属性を使用するジョブについてページの範囲を印刷する場合、印刷対象の最終ページ (論理和) を返します。
int	hashCode() この JobAttributes のハッシュコード値を返します。
void	set(JobAttributes obj) この JobAttributes のすべての属性を obj の属性と同じ値に設定します。
void	setCopies(int copies) これらの属性を使うジョブに対して、アプリケーションが描画する必要のあるコピーの数を指定します。
void	setCopiesToDefault() これらの属性を使うジョブに対して、アプリケーションが描画しなければならないコピーの数をデフォルトに設定します。
void	setDefaultSelection(JobAttributes.DefaultSelectionType defaultSelection) これらの属性を使用するジョブについて、アプリケーションが、すべてのページ、getPageRanges の戻り値によって指定された範囲、現在の選択のいずれを出力するかを指定します。
void	setDestination(JobAttributes.DestinationType destination) これらの属性を使用するジョブについて、プリンタまたはファイルのどちらに出力するかを指定します。
void	setDialog(JobAttributes.DialogType dialog) これらの属性を使用するジョブについて、ユーザーが印刷の設定を変更する印刷のダイアログを見る必要があるか、そしてどのタイプの印刷のダイアログが表示されるべきかを返します。
void	setFileName(String fileName) これらの属性を使うジョブに対して、出力ファイルの名前を指定します。
void	setFromPage(int fromPage) これらの属性を使用するジョブについてページの範囲を印刷する場合、印刷対象の最初のページを指定します。
void	setMaxPage(int maxPage) これらの属性を使用するジョブについて、ユーザーが指定できる最大値を印刷対象の最終ページとして指定します。
void	setMinPage(int minPage) これらの属性を使用するジョブについて、ユーザーが指定できる最小値を印刷対象の開始ページとして指定します。
void	setMultipleDocumentHandling(JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling) これらの属性を使用するジョブについて、複数のコピーの処理 (照合を含む) を指定します。
void	setMultipleDocumentHandlingToDefault() これらの属性を使用するジョブについて、複数のコピーの処理 (照合を含む) をデフォルトに設定します。
void	setPageRanges(int[][] pageRanges) これらの属性を使用するジョブについてページの範囲を印刷する場合、印刷対象のページの範囲を指定します。
void	setPrinter(String printer) これらの属性を使用するジョブについて、出力先プリンタを指定します。
void	setSides(JobAttributes.SidesType sides) これらの属性を使用するジョブについて、印刷メディアのサイドに連続したページが組み付けられる方法を指定します。
void	setSidesToDefault() これらの属性を使用するジョブについて、印刷メディアのサイドに連続したページが組み付ける方法をデフォルトに設定します。
void	setToPage(int toPage) これらの属性を使用するジョブについてページの範囲を印刷する場合、印刷対象の最終ページ (論理和) を指定します。
String	toString() この JobAttributes の文字列表現を返します。

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

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

コンストラクタの詳細

JobAttributes

public JobAttributes()

すべての属性にデフォルト値を使用して、JobAttributes インスタンスを構築します。ダイアログは、デフォルトで DialogType.NATIVE です。最小ページは、デフォルトで 1 です。最大ページは、デフォルトで Integer.MAX_VALUE です。出力先は、デフォルトで DestinationType.PRINTER です。選択は、デフォルトで DefaultSelectionType.ALL です。コピーの部数は、デフォルトで 1 です。複数のドキュメント処理は、デフォルトで MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES です。面の処理は、デフォルトで SidesType.ONE_SIDED です。ファイル名は、デフォルトで null です。

JobAttributes

public JobAttributes(JobAttributes obj)

指定された JobAttributes のコピーである JobAttributes インスタンスを構築します。

パラメータ:

obj - コピーする JobAttributes

JobAttributes

public JobAttributes(int copies,
             JobAttributes.DefaultSelectionType defaultSelection,
             JobAttributes.DestinationType destination,
             JobAttributes.DialogType dialog,
             String fileName,
             int maxPage,
             int minPage,
             JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling,
             int[][] pageRanges,
             String printer,
             JobAttributes.SidesType sides)

すべての属性に指定された値を使用して、JobAttributes インスタンスを構築します。

パラメータ:

copies - 0 より大きい整数

defaultSelection - DefaultSelectionType.ALL、DefaultSelectionType.RANGE、または DefaultSelectionType.SELECTION

destination - DesintationType.FILE または DesintationType.PRINTER

dialog - DialogType.COMMON、DialogType.NATIVE、または DialogType.NONE

fileName - null の可能性があるファイル名

maxPage - 0 より大きく、minPage 以上の整数

minPage - 0 より大きく maxPage 以下の整数値

multipleDocumentHandling - MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_COLLATED_COPIES または MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES

pageRanges - 2 要素の整数配列の配列。指定したページを含み、かつ、指定した全ページにまたがる範囲として解釈される。範囲は昇順とし、オーバーラップしてはならない。指定されたページ番号は minPage 未満にも、maxPage より大きくなることもない。次に例を示す。

          (new int[][] { new int[] { 1, 3 }, new int[] { 5, 5 },
                         new int[] { 15, 19 } }),
          

ページ 1、2、3、5、15、16、17、18、および 19 を指定することになる。ただし、(new int[][] { new int[] { 1, 1 }, new int[] { 1, 2 } }) の場合は 2 つの範囲がオーバーラップしているため、ページ範囲のセットが無効になる

printer - null の可能性があるプリンタ名

sides - SidesType.ONE_SIDED、SidesType.TWO_SIDED_LONG_EDGE、または SidesType.TWO_SIDED_SHORT_EDGE

例外:

IllegalArgumentException - 上の条件の 1 つ以上に違反した場合

メソッドの詳細

clone

public Object clone()

この JobAttributes のコピーを作成して返します。

オーバーライド:

clone、クラス: Object

戻り値:

新しく作成されたコピー。この Object を JobAttributes にキャストすると安全である

関連項目:

Cloneable

set

public void set(JobAttributes obj)

この JobAttributes のすべての属性を obj の属性と同じ値に設定します。

パラメータ:

obj - コピーする JobAttributes

getCopies

public int getCopies()

これらの属性を使うジョブに対して、アプリケーションが描画する必要のあるコピーの数を返します。この属性は、ユーザーが選択した値に更新されます。

戻り値:

0 よりも大きい整数値

setCopies

public void setCopies(int copies)

これらの属性を使うジョブに対して、アプリケーションが描画する必要のあるコピーの数を指定します。この属性を指定しないと、1 を指定したことになります。

パラメータ:

copies - 0 より大きい整数

例外:

IllegalArgumentException - copies が 0 以下の場合

setCopiesToDefault

public void setCopiesToDefault()

これらの属性を使うジョブに対して、アプリケーションが描画しなければならないコピーの数をデフォルトに設定します。デフォルトのコピーの数は、1 です。

getDefaultSelection

public JobAttributes.DefaultSelectionType getDefaultSelection()

これらの属性を使用するジョブについて、アプリケーションが、すべてのページ、getPageRanges の戻り値によって指定された範囲、現在の選択のいずれを出力するかを指定します。この属性は、ユーザーが選択した値に更新されます。

戻り値:

DefaultSelectionType.ALL、DefaultSelectionType.RANGE、または DefaultSelectionType.SELECTION

setDefaultSelection

public void setDefaultSelection(JobAttributes.DefaultSelectionType defaultSelection)

これらの属性を使用するジョブについて、アプリケーションが、すべてのページ、getPageRanges の戻り値によって指定された範囲、現在の選択のいずれを出力するかを指定します。この属性を指定しないと、DefaultSelectionType.ALL を指定したことになります。

パラメータ:

defaultSelection - DefaultSelectionType.ALL、DefaultSelectionType.RANGE、または DefaultSelectionType.SELECTION。

例外:

IllegalArgumentException - defaultSelection が null の場合

getDestination

public JobAttributes.DestinationType getDestination()

これらの属性を使用するジョブについて、プリンタまたはファイルのどちらに出力するかを指定します。この属性は、ユーザーが選択した値に更新されます。

戻り値:

DesintationType.FILE または DesintationType.PRINTER

setDestination

public void setDestination(JobAttributes.DestinationType destination)

これらの属性を使用するジョブについて、プリンタまたはファイルのどちらに出力するかを指定します。この属性を指定しないと、DesintationType.PRINTER を指定したことになります。

パラメータ:

destination - DesintationType.FILE または DesintationType.PRINTER。

例外:

IllegalArgumentException - 出力先が null の場合。

getDialog

public JobAttributes.DialogType getDialog()

これらの属性を使用するジョブについて、ユーザーが印刷の設定を変更する印刷のダイアログを見る必要があるか、そしてどのタイプの印刷のダイアログが表示されるべきかを返します。DialogType.COMMON は共通プラットフォームの Pure Java 印刷ダイアログを表します。DialogType.NATIVE は、同じプラットフォームのネイティブな印刷ダイアログを表します。プラットフォームがネイティブな印刷ダイアログをサポートしていない場合は、代わりに Pure Java の印刷ダイアログが表示されます。DialogType.NONE はバックグラウンド印刷などの印刷ダイアログを指定しません。この属性は、実装や出力先プリンタによる変更や制限を受けることはありません。

戻り値:

DialogType.COMMON、DialogType.NATIVE、または DialogType.NONE

setDialog

public void setDialog(JobAttributes.DialogType dialog)

これらの属性を使用するジョブについて、ユーザーが印刷の設定を変更する印刷のダイアログを見る必要があるか、そしてどのタイプの印刷のダイアログが表示されるべきかを返します。DialogType.COMMON は共通プラットフォームの Pure Java 印刷ダイアログを表します。DialogType.NATIVE は、同じプラットフォームのネイティブな印刷ダイアログを表します。プラットフォームがネイティブな印刷ダイアログをサポートしていない場合は、代わりに Pure Java の印刷ダイアログが表示されます。DialogType.NONE はバックグラウンド印刷などの印刷ダイアログを指定しません。この属性を変更しないと、DialogType.NATIVE を指定したことになります。

パラメータ:

dialog - DialogType.COMMON、DialogType.NATIVE、または DialogType.NONE。

例外:

IllegalArgumentException - ダイアログが null の場合。

getFileName

public String getFileName()

これらの属性を使うジョブに対して、出力ファイルの名前を指定します。この属性は、ユーザーが選択した値に更新されます。

戻り値:

null の可能性があるファイル名

setFileName

public void setFileName(String fileName)

これらの属性を使うジョブに対して、出力ファイルの名前を指定します。デフォルトは、プラットフォームに依存し、実装で定義されています。

パラメータ:

fileName - null の可能性があるファイル名。

getFromPage

public int getFromPage()

これらの属性を使用するジョブについてページの範囲を印刷する場合、印刷対象の最初のページを返します。この属性は、ユーザーが選択した値に更新されます。アプリケーションは、 getDefaultSelection メソッドの戻り値が DefaultSelectionType.RANGE でないかぎり、出力でこの属性を無視するようにしてください。アプリケーションは、可能であれば、このメソッドの戻り値より getPageRanges の戻り値に従うようにしてください。

戻り値:

0 より大きく toPage 以下、minPage 以上で maxPage 以下の整数値。

setFromPage

public void setFromPage(int fromPage)

これらの属性を使用するジョブについてページの範囲を印刷する場合、印刷対象の最初のページを指定します。この属性を指定しない場合は、pageRanges 属性の値が使用されます。pageRanges と、fromPage および toPage のどちらか一方、またはその両方が指定された場合、pageRanges が優先されます。pageRanges、fromPage、toPage のいずれも指定しないと、setPageRanges(new int[][] { new int[] { minPage } }) を呼び出したことになります。

パラメータ:

fromPage - 0 より大きく toPage 以下、minPage 以上で maxPage 以下の整数値。

例外:

IllegalArgumentException - 上の条件の 1 つ以上に違反した場合。

getMaxPage

public int getMaxPage()

これらの属性を使用するジョブについて、ユーザーが指定できる最大値を印刷対象の最終ページとして指定します。この属性は、実装や出力先プリンタによる変更や制限を受けることはありません。

戻り値:

0 より大きく、minPage 以上の整数。

setMaxPage

public void setMaxPage(int maxPage)

これらの属性を使用するジョブについて、ユーザーが指定できる最大値を印刷対象の最終ページとして指定します。この属性を指定しないと、Integer.MAX_VALUE を指定したことになります。

パラメータ:

maxPage - 0 より大きく、minPage 以上の整数

例外:

IllegalArgumentException - 上の条件の 1 つ以上に違反した場合

getMinPage

public int getMinPage()

これらの属性を使用するジョブについて、ユーザーが指定できる最小値を印刷対象の開始ページとして指定します。この属性は、実装や出力先プリンタによる変更や制限を受けることはありません。

戻り値:

0 より大きく maxPage 以下の整数値。

setMinPage

public void setMinPage(int minPage)

これらの属性を使用するジョブについて、ユーザーが指定できる最小値を印刷対象の開始ページとして指定します。この属性を指定しないと、1 を指定したことになります。

パラメータ:

minPage - 0 より大きく maxPage 以下の整数値。

例外:

IllegalArgumentException - 上の条件の 1 つ以上に違反した場合。

getMultipleDocumentHandling

public JobAttributes.MultipleDocumentHandlingType getMultipleDocumentHandling()

これらの属性を使用するジョブについて、複数のコピーの処理 (照合を含む) を指定します。この属性は、ユーザーが選択した値に更新されます。

戻り値:

MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_COLLATED_COPIES または MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES.

setMultipleDocumentHandling

public void setMultipleDocumentHandling(JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling)

これらの属性を使用するジョブについて、複数のコピーの処理 (照合を含む) を指定します。この属性を指定しないと、MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES を指定したことになります。

パラメータ:

multipleDocumentHandling - MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_COLLATED_COPIES または MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES。

例外:

IllegalArgumentException - multipleDocumentHandling が null の場合。

setMultipleDocumentHandlingToDefault

public void setMultipleDocumentHandlingToDefault()

これらの属性を使用するジョブについて、複数のコピーの処理 (照合を含む) をデフォルトに設定します。このデフォルト処理は、MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES となります。

getPageRanges

public int[][] getPageRanges()

これらの属性を使用するジョブについてページの範囲を印刷する場合、印刷対象のページの範囲を指定します。すべての番号範囲が含まれています。この属性は、ユーザーが選択した値に更新されます。getDefaultSelection メソッドの戻り値が DefaultSelectionType.RANGE でない場合は、アプリケーションは出力に関するこの属性を無視します。

戻り値:

2 つの要素を配列する整数配列。配列は、指定されたページとページの間 (両方のページを含む) のすべてのページにまたがる範囲として解釈されます。範囲は昇順である必要があり、オーバーラップしていてはいけません。指定されたページ番号が minPage より小さかったり、maxPage より大きかったりしてはいけません。たとえば、(new int[][] { new int[] { 1, 3 }, new int[] { 5, 5 }, new int[] { 15, 19 } }) はページ 1、2、3、5、15、16、17、18、および 19 を指定することになる。

setPageRanges

public void setPageRanges(int[][] pageRanges)

これらの属性を使用するジョブについてページの範囲を印刷する場合、印刷対象のページの範囲を指定します。すべての番号範囲が含まれています。この属性を指定しない場合は、fromPage から toPage までの属性の値が使用されます。pageRanges と、fromPage および toPage のどちらか一方、またはその両方が指定された場合、pageRanges が優先されます。pageRanges、fromPage、toPage のいずれも指定しないと、setPageRanges(new int[][] { new int[] { minPage, minPage } }) を呼び出したことになります。

パラメータ:

pageRanges - 2 要素の整数配列の配列。配列は、指定されたページとページの間 (両方のページを含む) のすべてのページにまたがる範囲として解釈されます。範囲は昇順である必要があり、オーバーラップしていてはいけません。指定されたページ番号が minPage より小さかったり、maxPage より大きかったりしてはいけません。たとえば、(new int[][] { new int[] { 1, 3 }, new int[] { 5, 5 }, new int[] { 15, 19 } }) はページ 1、2、3、5、15、16、17、18、および 19 を指定することになる。ただし、(new int[][] { new int[] { 1, 1 }, new int[] { 1, 2 } }) の場合は 2 つの範囲がオーバーラップしているため、ページ範囲のセットが無効になる。

例外:

IllegalArgumentException - 上の条件の 1 つ以上に違反した場合。

getPrinter

public String getPrinter()

これらの属性を使用するジョブについて、出力先プリンタを返します。この属性は、ユーザーが選択した値に更新されます。

戻り値:

null の可能性があるプリンタ名

setPrinter

public void setPrinter(String printer)

これらの属性を使用するジョブについて、出力先プリンタを指定します。デフォルトは、プラットフォームに依存し、実装で定義されています。

パラメータ:

printer - null の可能性があるプリンタ名。

getSides

public JobAttributes.SidesType getSides()

これらの属性を使用するジョブについて、印刷メディアのサイドに連続したページが組み付けられる方法を返します。SidesType.ONE_SIDED は、連続したメディアシートの同じ面に各連続ページを組み付けます。この組み付けは simplex と呼ばれる場合があります。SidesType.TWO_SIDED_LONG_EDGE は、連続ページの各ペアを連続メディアシートの表面と裏面に組み付けます。このときメディアの各ペアのページの方向を、読取装置が長い端をバインディングしたかのように正しく設定します。この組み付けは duplex と呼ばれる場合があります。SidesType.TWO_SIDED_SHORT_EDGE は、連続ページの各ペアを連続ページの各ペアを連続メディアシートの前面と裏面に組み付けます。このときメディアの各ペアのページの方向を、読取装置が短い端をバインディングしたかのように正しく設定します。この組み付けは tumble と呼ばれる場合があります。この属性は、ユーザーが選択した値に更新されます。

戻り値:

SidesType.ONE_SIDED、SidesType.TWO_SIDED_LONG_EDGE、または SidesType.TWO_SIDED_SHORT_EDGE

setSides

public void setSides(JobAttributes.SidesType sides)

これらの属性を使用するジョブについて、印刷メディアのサイドに連続したページが組み付けられる方法を指定します。SidesType.ONE_SIDED は、連続したメディアシートの同じ面に各連続ページを組み付けます。この組み付けは simplex と呼ばれる場合があります。SidesType.TWO_SIDED_LONG_EDGE は、連続ページの各ペアを連続メディアシートの表面と裏面に組み付けます。このときメディアの各ペアのページの方向を、読取装置が長い端をバインディングしたかのように正しく設定します。この組み付けは duplex と呼ばれる場合があります。SidesType.TWO_SIDED_SHORT_EDGE は、連続ページの各ペアを連続ページの各ペアを連続メディアシートの前面と裏面に組み付けます。このときメディアの各ペアのページの方向を、読取装置が短い端をバインディングしたかのように正しく設定します。この組み付けは tumble と呼ばれる場合があります。この属性を指定しないと、SidesType.ONE_SIDED を指定した場合と同じになります。

パラメータ:

sides - SidesType.ONE_SIDED、SidesType.TWO_SIDED_LONG_EDGE、または SidesType.TWO_SIDED_SHORT_EDGE。

例外:

IllegalArgumentException - sides が null の場合。

setSidesToDefault

public void setSidesToDefault()

これらの属性を使用するジョブについて、印刷メディアのサイドに連続したページが組み付ける方法をデフォルトに設定します。デフォルトの組み付けは SidesType.ONE_SIDED です。

getToPage

public int getToPage()

これらの属性を使用するジョブについてページの範囲を印刷する場合、印刷対象の最終ページ (論理和) を返します。この属性は、ユーザーが選択した値に更新されます。アプリケーションは、 getDefaultSelection メソッドの戻り値が DefaultSelectionType.RANGE でないかぎり、出力でこの属性を無視するようにしてください。アプリケーションは、可能であれば、このメソッドの戻り値より getPageRanges の戻り値に従うようにしてください。

戻り値:

0 より大きく toPage 以上、minPage 以上で maxPage 以下の整数値。

setToPage

public void setToPage(int toPage)

これらの属性を使用するジョブについてページの範囲を印刷する場合、印刷対象の最終ページ (論理和) を指定します。この属性を指定しない場合は、pageRanges 属性の値が使用されます。pageRanges と、fromPage および toPage のどちらか一方、またはその両方が指定された場合、pageRanges が優先されます。pageRanges、fromPage、toPage のいずれも指定しないと、setPageRanges(new int[][] { new int[] { minPage } }) を呼び出したことになります。

パラメータ:

toPage - 0 より大きく fromPage 以上、minPage 以上で maxPage 以下の整数値。

例外:

IllegalArgumentException - 上の条件の 1 つ以上に違反した場合。

equals

public boolean equals(Object obj)

2 つの JobAttributes が同じであるかどうかを判定します。

JobAttributes の属性が同じ場合にのみ、2 つの JobAttributes は同一です。フィールドが一意の同じ列挙オブジェクトを参照している場合にだけ、列挙型の属性が等しくなります。ページ範囲のセットは、そのセットが同一の長さで、各範囲が同じページ数を列挙し、その範囲が同一の順になっている場合にのみ、同一になります。

オーバーライド:

equals、クラス: Object

パラメータ:

obj - 同じであるかどうかがチェックされるオブジェクト。

戻り値:

上記の基準により、obj がこの JobAttribute と等しいかどうか

関連項目:

Object.hashCode(), HashMap

hashCode

public int hashCode()

この JobAttributes のハッシュコード値を返します。

オーバーライド:

hashCode、クラス: Object

戻り値:

ハッシュコード

関連項目:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

この JobAttributes の文字列表現を返します。

オーバーライド:

toString、クラス: Object

戻り値:

文字列表現。