当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

JobState (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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           作业已成功完成，或以警告或错误结束，所有作业介质纸张已成功堆栈到适当的输出纸盒（或多个纸盒）中，且所有作业状态已达到作业的最终值。
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

作业已成功完成，或以警告或错误结束，所有作业介质纸张已成功堆栈到适当的输出纸盒（或多个纸盒）中，且所有作业状态已达到作业的最终值。作业的 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

返回：

属性类别名称。

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。