JobAttributes (Java Platform SE 8)

java.lang.Object
- java.awt.JobAttributes

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

Cloneable
```
public final class JobAttributes
extends Object
implements Cloneable
```
印刷ジョブを制御する属性セットです。
このクラスのインスタンスは、このインスタンスを使用している各印刷ジョブの、コピーの部数、デフォルトの選択、出力先、印刷のダイアログ、ファイル名とプリンタ名、ページ範囲、複数のドキュメント処理(照合を含む)、デュープレックスのような複数ページの組み付けなどを制御します。属性名は、可能な場合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
    
    戻り値:
    
    文字列表現。

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスJobAttributes

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

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

メソッドのサマリー

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

コンストラクタの詳細

JobAttributes

JobAttributes

JobAttributes

メソッドの詳細

clone

set

getCopies

setCopies

setCopiesToDefault

getDefaultSelection

setDefaultSelection

getDestination

setDestination

getDialog

setDialog

getFileName

setFileName

getFromPage

setFromPage

getMaxPage

setMaxPage

getMinPage

setMinPage

getMultipleDocumentHandling

setMultipleDocumentHandling

setMultipleDocumentHandlingToDefault

getPageRanges

setPageRanges

getPrinter

setPrinter

getSides

setSides

setSidesToDefault

getToPage

setToPage

equals

hashCode

toString