Module java.desktop

软件包 javax.print.attribute.standard

Class JobStateReasons

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractSet<E>

java.util.HashSet<JobStateReason>

javax.print.attribute.standard.JobStateReasons

All Implemented Interfaces:

Serializable ， Cloneable ， Iterable<JobStateReason> ， Collection<JobStateReason> ， Set<JobStateReason> ， Attribute ， PrintJobAttribute

public final class JobStateReasons
extends HashSet<JobStateReason>
implements PrintJobAttribute

JobStateReasons类是一个打印属性类，一组枚举值，它提供有关作业当前状态的附加信息，即增加作业JobState属性值的信息。

JobStateReason的实例不会直接显示在打印作业的属性集中。 相反，JobStateReasons属性出现在打印作业的属性集中。 JobStateReasons属性包含与打印作业状态相关的零个，一个或多个JobStateReason对象。 当打印作业的相应条件变为true时，打印机将向打印作业的JobStateReasons属性添加一个JobStateReason对象，并且当相应条件变为false时，打印机将再次删除JobStateReason对象，而不管打印作业的整体JobState是否也改变。

JobStateReasons类继承自java.util.HashSet类的实现 。 与大多数不可修改的打印属性不同，JobStateReasons类被设计为可变的; 您可以将JobStateReason对象添加到现有的JobStateReasons对象中，并再次删除。 但是，像类java.util.HashSet一样 ，JobStateReasons类不是多线程安全的。 如果多个线程使用JobStateReasons对象，请确保同步其操作（例如，使用从java.util.Collections类获取的同步集视图）。

IPP兼容性：每个人JobStateReason对象的toString()方法返回的字符串值给出IPP关键字值。 由getName()返回的类别名称提供IPP属性名称。

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor	描述
JobStateReasons()	构造一个新的，空的作业状态原因属性; 底层哈希集具有默认的初始容量和负载因子。
JobStateReasons(int initialCapacity)	构造一个新的，空的作业状态原因属性; 底层哈希集具有给定的初始容量和默认负载因子。
JobStateReasons(int initialCapacity, float loadFactor)	构造一个新的，空的作业状态原因属性; 底层哈希集具有给定的初始容量和负载因子。
JobStateReasons(Collection<JobStateReason> collection)	构造一个新的作业状态原因属性，其中包含与给定集合相同的JobStateReason对象。

方法摘要

Modifier and Type	方法	描述
boolean	add(JobStateReason o)	如果指定的元素不存在，则将此指定元素添加到此作业状态reason属性。
Class<? extends Attribute>	getCategory()	获取要用作此打印属性值的“类别”的打印属性类。
String	getName()	获取此属性值是一个实例的类别的名称。

Methods inherited from class java.util.AbstractCollection

addAll, containsAll, retainAll, toArray, toArray, toString

Methods inherited from class java.util.AbstractSet

equals, hashCode, removeAll

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from class java.util.HashSet

clear, clone, contains, isEmpty, iterator, remove, size, spliterator

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Set

addAll, containsAll, equals, hashCode, of, of, of, of, of, of, of, of, of, of, of, of, removeAll, retainAll, toArray, toArray

构造方法详细信息

JobStateReasons

public JobStateReasons()

构造一个新的，空的作业状态原因属性; 底层哈希集具有默认的初始容量和负载因子。

JobStateReasons

public JobStateReasons(int initialCapacity)

构造一个新的，空的作业状态原因属性; 底层哈希集具有给定的初始容量和默认负载因子。

参数

initialCapacity - 初始容量。

异常

IllegalArgumentException - 如果初始容量小于零。

JobStateReasons

public JobStateReasons(int initialCapacity,
                       float loadFactor)

构造一个新的，空的作业状态原因属性; 底层哈希集具有给定的初始容量和负载因子。

参数

initialCapacity - 初始容量。

loadFactor - 负载系数。

异常

IllegalArgumentException - 如果初始容量小于零。

JobStateReasons

public JobStateReasons(Collection<JobStateReason> collection)

构造一个新的作业状态原因属性，其中包含与给定集合相同的JobStateReason对象。 底层哈希集的初始容量和负载因子如超类构造函数HashSet(Collection)中所规定。

参数

collection - 要复制的集合。

异常

NullPointerException - （未经检查的异常）如果抛出该异常 collection为空，或者如果在任何元件 collection为空。

ClassCastException - （未选中的异常）抛出collection任何元素不是JobStateReason类的实例。

方法详细信息

add

public boolean add(JobStateReason o)

如果指定的元素不存在，则将此指定元素添加到此作业状态reason属性。 要添加的元素必须是JobStateReason类的实例。 如果此作业状态原因属性已经包含指定的元素，则此作业状态原因属性不变，并返回false 。

Specified by:

add在接口 Collection<JobStateReason>

Specified by:

add接口 Set<JobStateReason>

重写：

add在 HashSet<JobStateReason>

参数

o - 要添加到此作业状态的元素的属性。

结果

true如果此作业状态原因属性尚未包含指定的元素。

异常

NullPointerException - （未检查的异常）如果指定的元素为空，则抛出。

ClassCastException - （未经检查的异常）如果指定的元素不是类JobStateReason的实例，则抛出 。

从以下版本开始：

1.5

getCategory

public final Class<? extends Attribute> getCategory()

获取要用作此打印属性值的“类别”的打印属性类。

对于JobStateReasons类，该类别是JobStateReasons类。

Specified by:

getCategory在接口 Attribute

结果

打印属性类（category），一个java.lang.Class类的实例。

getName

public final String getName()

获取此属性值是一个实例的类别的名称。

对于JobStateReasons类，类别名称为"job-state-reasons" 。

Specified by:

getName在接口 Attribute

结果

Attribute category name.