モジュール java.desktop
パッケージ javax.print.attribute.standard

クラスJobHoldUntil

  • すべての実装されたインタフェース:
    Serializable, Cloneable, Attribute, PrintJobAttribute, PrintRequestAttribute
    public final class JobHoldUntil
extends DateTimeSyntax
implements PrintRequestAttribute, PrintJobAttribute
    クラスJobHoldUntilは、ジョブが印刷の候補になる必要がある正確な日時を指定する日時属性の印刷属性クラスです。

    この属性の値が将来の日時を指定する場合、プリンタはジョブJobStateReasons属性にJOB_HOLD_UNTIL_SPECIFIEDのJobStateReason値を追加し、ジョブをPENDING_HELD状態に移動し、ジョブをジョブがスケジュールされるまでスケジュールする必要があります。指定された日時が到着します。

    指定された日時が到着したら、ジョブJobStateReasons属性(存在する場合)からJOB_HOLD_UNTIL_SPECIFIEDのJobStateReason値を削除する必要があります。 ジョブをPENDING_HELD状態に保つ他のジョブ状態の理由がない場合、プリンタは、ジョブをPENDING状態に移動させることによってジョブを処理の候補と見なさなければなりません。

    指定された日付と時刻をすでに過ぎた場合、ジョブはただちに処理対象の候補にしなければいけません。 したがって、ジョブを直ちに処理の候補にする1つの方法は、この(1970年1月1日の00:00:00 GMTの日付時間を示します。)のように構築されたJobHoldUntil属性を指定することです : 

         JobHoldUntil immediately = new JobHoldUntil (new Date (0L));

    クライアントが印刷リクエストでこの属性を提供せず、プリンタがこの属性をサポートしている場合、プリンタはジョブ送信時間(ジョブ処理時に必要に応じて使用されるほとんどのジョブ・テンプレート属性とは異なります)で(implementation-dependent)デフォルトJobHoldUntil値を使用する必要があります。

    年、月、日、時、分などの別々の値からJobHoldUntil属性を構成するには、Calendarオブジェクトを使用してDateオブジェクトを作成し、次にDateオブジェクトを使用してJobHoldUntil属性を構築します。 JobHoldUntil属性を年、月、日、時、分などの別々の値に変換するには、Calendarオブジェクトを作成し、JobHoldUntil属性からDateに設定します。

    IPP互換性: IPPはキーワードとして指定されたjob-hold-until属性をサポートしますが、IPPは日付と時間として指定されたjob-hold-until属性を現在サポートしていません。 ただし、日付と時刻を標準のIPPキーワードの1つに変換して精度を低下させることもできます。たとえば、現在の日付と現地時間の午後9時のJobHoldUntilの値は、標準のIPPキーワード"night"に変換されます。 getName()によって返されるカテゴリ名はIPP属性の名前を示します。

    関連項目:
    直列化された形式

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

      コンストラクタ 
      コンストラクタ 説明
      JobHoldUntil​(Date dateTime)
      指定されたDateの値で、新しいジョブ保留日時属性を構築します。

    • メソッドのサマリー

      修飾子と型 メソッド 説明
      boolean equals​(Object object)
      このジョブ保留属性がオブジェクトに渡された属性と等しいかどうかを返します。
      Class<? extends Attribute> getCategory()
      この印刷属性値のカテゴリとして使用される印刷属性クラスを返します。
      String getName()
      属性値がインスタンスとなるカテゴリの名前を返します。

    • コンストラクタの詳細

      • JobHoldUntil

        public JobHoldUntil​(Date dateTime)
        指定されたDateの値で、新しいジョブ保留日時属性を構築します。
        パラメータ:
        dateTime - Date値
        例外:
        NullPointerException - dateTimeがnullの場合

    • メソッドの詳細

      • equals

        public boolean equals​(Object object)
        このジョブ保留属性がオブジェクトに渡された属性と等しいかどうかを返します。 次の条件がすべてtrueの場合に同等とみなされます。
        1. objectはnullではありません。
        2. objectはJobHoldUntilクラスのインスタンスです。
        3. このジョブ保留属性のDate値とobjectのDate値が等しい。
        オーバーライド:
        equals、クラス: DateTimeSyntax
        パラメータ:
        object - 比較するObject
        戻り値:
        true objectがこのジョブの保留属性に相当する場合はfalse、それ以外の場合はfalse
        関連項目:
        Object.hashCode()、HashMap

      • getCategory

        public final Class<? extends Attribute> getCategory()
        この印刷属性値のカテゴリとして使用される印刷属性クラスを返します。

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

        定義:
        getCategory、インタフェース: Attribute
        戻り値:
        印刷属性クラス(category)、クラスjava.lang.Classのインスタンス

      • getName

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

        クラスJobHoldUntilの場合、カテゴリ名は"job-hold-until"です。

        定義:
        getName、インタフェース: Attribute
        戻り値:
        属性カテゴリ名