モジュール java.desktop
パッケージ java.awt

クラスJobAttributes

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 - DestinationType.FILEまたはDestinationType.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()
      これらの属性を使用するジョブについて、プリンタまたはファイルのどちらに出力するかを指定します。 この属性は、ユーザーが選択した値に更新されます。
      戻り値:
      DestinationType.FILEまたはDestinationType.PRINTER

    • setDestination

      public void setDestination​(JobAttributes.DestinationType destination)
      これらの属性を使用するジョブについて、プリンタまたはファイルのどちらに出力するかを指定します。 この属性を指定しない場合は、DestinationType.PRINTERを指定するのと同じです。
      パラメータ:
      destination - DestinationType.FILEまたはDestinationType.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
      戻り値:
      文字列表現。