javax.print.attribute.standard
類別 JobState

java.lang.Object
  javax.print.attribute.EnumSyntax
      javax.print.attribute.standard.JobState

所有已實作的介面：

Serializable, Cloneable, Attribute, PrintJobAttribute

public class JobState
extends EnumSyntax
implements PrintJobAttribute

JobState 是列印屬性類別，它是一個列舉值，標識了列印作業的當前狀態。JobState 類別定義了標準的作業狀態值。Print Service 實作只需報告適合於特殊實作的作業狀態；它不必報告每個定義的作業狀態。JobStateReasons 屬性擴充了 JobState 屬性，以給出有關處於給定作業狀態的作業的更詳細資訊。

IPP Compatibility: getName() 所返回的類別別名稱為 IPP 屬性名稱。列舉的整數值為 IPP 列舉值。toString() 方法返回屬性值的 IPP 字元串表示形式。

另請參見：

序列化表格

欄位摘要

static JobState	ABORTED 作業已被系統中止（通常當作業處於 PROCESSING 或 PROCESSING_STOPPED 狀態時），印表機已完成正在中止的作業，且所有作業狀態屬性已達到作業的最終值。
static JobState	CANCELED 作業已被人為操作取消，印表機已完成了正取消的作業，且所有作業狀態屬性已達到作業的最終值。
static JobState	COMPLETED 作業已成功完成，或以警告或錯誤結束，所有作業介質紙張已成功堆疊(stack)空間到適當的輸出紙盒（或多個紙盒）中，且所有作業狀態已達到作業的最終值。
static JobState	PENDING 作業為要開始處理的候選作業，但尚未開始處理。
static JobState	PENDING_HELD 由於某些原因，作業不是要處理的候選作業，但當這些原因不再存在時，作業將返回 PENDING 狀態。
static JobState	PROCESSING 正在處理作業。
static JobState	PROCESSING_STOPPED 由於某些原因，正在處理時作業已停止，且當這些原因不再存在時，作業返回到 PROCESSING 狀態。
static JobState	UNKNOWN 作業狀態是未知的。

建構子摘要

protected

JobState(int value) 建構具有給定整數值的新 JobState 列舉值。

方法摘要

Class<? extends Attribute>	getCategory() 獲取將被用作此列印屬性值的“類別別”的列印屬性類別。
protected EnumSyntax[]	getEnumValueTable() 返回 JobState 類別的列舉值表。
String	getName() 獲取類別別名稱，此屬性值為該類別別的實例。
protected String[]	getStringTable() 返回 JobState 類別的字元串表。

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

clone, getOffset, getValue, hashCode, readResolve, toString

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

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

欄位詳細資訊

UNKNOWN

public static final JobState UNKNOWN

作業狀態是未知的。

PENDING

public static final JobState PENDING

作業為要開始處理的候選作業，但尚未開始處理。

PENDING_HELD

public static final JobState PENDING_HELD

由於某些原因，作業不是要處理的候選作業，但當這些原因不再存在時，作業將返回 PENDING 狀態。作業的 JobStateReasons 屬性必須指示該作業為什麼不再是要處理的候選作業。

PROCESSING

public static final JobState PROCESSING

正在處理作業。以下一個或多個活動正在發生：

1. 作業正在使用（或正在嘗試使用）一個或多個純軟體進程，這些進程正在分析、創建或解釋某個 PDL，等等。

2. 作業正在使用（或正在嘗試使用）一個或多個硬體設備，這些設備正在解釋某個 PDL，正在介質上作標記，和/或正在執行結束操作，例如正在裝訂，等等。

3. 如果印表機已經就緒，但輸出設備尚未列印它，則要麼是因為該作業尚未到達輸出設備，要麼是因為該作業正在輸出設備或某些其他列印緩衝（spooler）中排隊, 等待輸入設備列印它。

當作業處於 PROCESSING 狀態時，全部作業狀態包括印表機的 PrinterState 和 PrinterStateReasons 屬性中所表示的詳細狀態。

實作可能（但不一定）包括作業的 JobStateReasons 屬性中的額外值，以指示列印進度，例如添加 JOB_PRINTING 值以指示輸出設備何時實際在紙張上進行標記，和/或添加 PROCESSING_TO_STOP_POINT 值以指示印表機處於取消或中止作業的進程中。

PROCESSING_STOPPED

public static final JobState PROCESSING_STOPPED

由於某些原因，正在處理時作業已停止，且當這些原因不再存在時，作業返回到 PROCESSING 狀態。

作業的 JobStateReasons 屬性可能指示為什麼作業已停止處理。例如，如果輸出設備停止，則作業的 JobStateReasons 屬性中可能包含 PRINTER_STOPPED 值。

註：當輸出設備停止時，該設備通常以設備上本地可讀形式指示其條件。客戶機可以通過查詢印表機的 PrinterState 和 PrinterStateReasons 屬性，遠端獲取更完整的設備狀態。

CANCELED

public static final JobState CANCELED

作業已被人為操作取消，印表機已完成了正取消的作業，且所有作業狀態屬性已達到作業的最終值。當印表機正取消作業時，該作業保持其當前狀態，但作業的 JobStateReasons 屬性應包含 PROCESSING_TO_STOP_POINT 值，以及 CANCELED_BY_USER、CANCELED_BY_OPERATOR 或 CANCELED_AT_DEVICE 值之一。當作業變為 CANCELED 狀態時，必須移除 PROCESSING_TO_STOP_POINT 值（如果存在），但必須保持 CANCELED_BY_xxx 值（如果存在）。

ABORTED

public static final JobState ABORTED

作業已被系統中止（通常當作業處於 PROCESSING 或 PROCESSING_STOPPED 狀態時），印表機已完成正在中止的作業，且所有作業狀態屬性已達到作業的最終值。當印表機正取消作業時，該作業保持其當前狀態，但作業的 JobStateReasons 屬性應包含 PROCESSING_TO_STOP_POINT 和 ABORTED_BY_SYSTEM 值。當作業變為 ABORTED 狀態時，必須移除 PROCESSING_TO_STOP_POINT 值（如果存在），但必須保持 ABORTED_BY_SYSTEM 值（如果存在）。

COMPLETED

public static final JobState COMPLETED

作業已成功完成，或以警告或錯誤結束，所有作業介質紙張已成功堆疊(stack)空間到適當的輸出紙盒（或多個紙盒）中，且所有作業狀態已達到作業的最終值。作業的 JobStateReasons 屬性應包含以下值之一：COMPLETED_SUCCESSFULLY、COMPLETED_WITH_WARNINGS 或 COMPLETED_WITH_ERRORS。

建構子詳細資訊

JobState

protected JobState(int value)

建構具有給定整數值的新 JobState 列舉值。

參數：

value - 整數值。

方法詳細資訊

getStringTable

protected String[] getStringTable()

返回 JobState 類別的字元串表。

覆寫：

類別 EnumSyntax 中的 getStringTable

返回：

字元串表

getEnumValueTable

protected EnumSyntax[] getEnumValueTable()

返回 JobState 類別的列舉值表。

覆寫：

類別 EnumSyntax 中的 getEnumValueTable

返回：

值表

getCategory

public final Class<? extends Attribute> getCategory()

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

對於 JobState 類別和任何供應商定義的子類別，類別別為 JobState 類別本身。

指定者：

介面 Attribute 中的 getCategory

返回：

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

getName

public final String getName()

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

對於 JobState 類別和任何供應商定義的子類別，類別別名稱為 "job-state"。

指定者：

介面 Attribute 中的 getName

返回：

屬性類別別名稱。