javax.print.attribute.standard
類別 JobHoldUntil

java.lang.Object
  javax.print.attribute.DateTimeSyntax
      javax.print.attribute.standard.JobHoldUntil

所有已實作的介面：

Serializable, Cloneable, Attribute, PrintJobAttribute, PrintRequestAttribute

public final class JobHoldUntil
extends DateTimeSyntax
implements PrintRequestAttribute, PrintJobAttribute

JobHoldUntil 類別是列印屬性類別，它是一個日期-時間屬性，指定了作業必須成為候選列印作業的準確日期和時間。

如果此屬性的值指定了將來的某個日期-時間，則印表機應將 JOB_HOLD_UNTIL_SPECIFIED 的 JobStateReason 值添加到作業的 JobStateReasons 屬性，必須將作業移動到 PENDING_HELD 狀態，並且在指定的日期-時間到來之前不能安排該列印作業。

當指定的日期-時間到來時，印表機必須從作業的 JobStateReasons 屬性中移除 JOB_HOLD_UNTIL_SPECIFIED 的 JobStateReason 值（如果存在）。如果沒有其他使列印作業保持為 PENDING_HELD 狀態的作業狀態原因，則印表機必須將該作業移動到 PENDING 狀態，以將其作為處理的候選作業。

如果已經超過指定的日期-時間，則該作業必須立即成為處理的候選作業。因此，使列印作業立即成為候選作業的一種方法是指定建構如下的 JobHoldUntil 屬性（表示的日期-時間為 GMT 時間 1970 年 1 月 1 日，00:00:00）：

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

如果客戶機沒有在 Print Request 中提供此屬性，且印表機支持此屬性，則印表機必須使用其（與實作有關的）預設的作業提交時的 JobHoldUntil 值（與作業處理時必要時所使用的大多數作業模板屬性不同）。

要從獨立的 year、month、day、hour、minute 等值建構 JobHoldUntil 屬性，請使用 Calendar 物件來建構一個 Date 物件，然後使用該 Date 物件來建構 JobHoldUntil 屬性。要將 JobHoldUntil 屬性轉換為獨立的 year、month、day、hour、minute 等值，請創建一個 Calendar 物件，並根據 JobHoldUntil 屬性將它設置為 Date。

IPP Compatibility: 雖然 IPP 支持指定為關鍵字的 "job-hold-until" 屬性，但此處 IPP 不支持指定為日期和時間的 "job-hold-until" 屬性。但是，可以在丟失一定精度的情況下，將日期和時間轉換為標準 IPP 關鍵字之一；例如，日期為今天、時間為本地時間 9:00pm 的 JobHoldUntil 值可以轉換為標準的 IPP 關鍵字 "night"。getName() 所返回的類別別名稱給出了 IPP 屬性名稱。

另請參見：

序列化表格

建構子摘要

JobHoldUntil(Date dateTime)
建構具有給定 Date 值新 JobHoldUntil 屬性。

方法摘要

boolean	equals(Object object) 返回此 JobHoldUntil 屬性是否等效於傳入的物件。
Class<? extends Attribute>	getCategory() 獲取將被用作此列印屬性值的“類別別”的列印屬性類別。
String	getName() 獲取類別別名稱，此屬性值為該類別別的實例。

從類別 javax.print.attribute.DateTimeSyntax 繼承的方法

getValue, hashCode, toString

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

JobHoldUntil

public JobHoldUntil(Date dateTime)

建構具有給定 Date 值新 JobHoldUntil 屬性。

參數：

dateTime - Date 值。

拋出：

NullPointerException - （未檢查的異常）如果 dateTime 為 null，則拋出此異常。

方法詳細資訊

equals

public boolean equals(Object object)

返回此 JobHoldUntil 屬性是否等效於傳入的物件。若要等效，以下所有條件都必須為 true：

1. object 不為 null。
2. object 為 JobHoldUntil 類別的實例。
3. 此 JobHoldUntil 屬性的 Date 值與 object 的 Date 值相等。

覆寫：

類別 DateTimeSyntax 中的 equals

參數：

object - 要比較的 Object。

返回：

如果 object 等效於此 JobHoldUntil 屬性，則返回 true，否則返回 false。

另請參見：

Object.hashCode(), Hashtable

getCategory

public final Class<? extends Attribute> getCategory()

獲取將被用作此列印屬性值的“類別別”的列印屬性類別。

對於 JobHoldUntil 類別，類別別為 JobHoldUntil 類別本身。

指定者：

介面 Attribute 中的 getCategory

返回：

列印屬性類別（類別別），它是 java.lang.Class 類別的實例。

getName

public final String getName()

獲取類別別名稱，此屬性值為該類別別的實例。

對於 JobHoldUntil 類別，類別別名稱為 "job-hold-until"。

指定者：

介面 Attribute 中的 getName

返回：

屬性類別別名稱。