JavaTM 2 Platform
Standard Ed. 5.0

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)
          构造具有给定整数值的新作业状态枚举值。
 
方法摘要
 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 状态时,全部作业状态包括打印机的 PrinterStatePrinterStateReasons 属性中所表示的详细状态。

实现可能(但不一定)包括作业的 JobStateReasons 属性中的额外值,以指示打印进度,例如添加 JOB_PRINTING 值以指示输出设备何时实际在纸张上进行标记,和/或添加 PROCESSING_TO_STOP_POINT 值以指示打印机处于取消或中止作业的进程中。


PROCESSING_STOPPED

public static final JobState PROCESSING_STOPPED
由于某些原因,正在处理时作业已停止,且当这些原因不再存在时,作业返回到 PROCESSING 状态。

作业的 JobStateReasons 属性可能指示为什么作业已停止处理。例如,如果输出设备停止,则作业的 JobStateReasons 属性中可能包含 PRINTER_STOPPED 值。

注:当输出设备停止时,该设备通常以设备上本地可读形式指示其条件。客户机可以通过查询打印机的 PrinterStatePrinterStateReasons 属性,远程获取更完整的设备状态。


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)
构造具有给定整数值的新作业状态枚举值。

参数:
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 2 Platform
Standard Ed. 5.0

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

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