javax.print.attribute.standard
類別 JobStateReasons

java.lang.Object
  java.util.AbstractCollection<E>
      java.util.AbstractSet<E>
          java.util.HashSet<JobStateReason>
              javax.print.attribute.standard.JobStateReasons

所有已實作的介面：

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

public final class JobStateReasons
extends HashSet<JobStateReason>
implements PrintJobAttribute

JobStateReasons 類別是列印屬性類別，它是一個列舉值集合，提供了有關作業當前狀態的額外資訊，即擴充作業的 JobState 屬性值的資訊。

JobStateReason 的實例不直接出現在 Print Job 的屬性集中。但是，JobStateReasons 屬性出現在 Print Job 的屬性集中。JobStateReasons 屬性包含零個、一個或多個 JobStateReason 物件，它們屬於 Print Job 的狀態。當 Print Job 的對應條件變為 true 時，印表機將 JobStateReason 物件添加到 Print Job 的 JobStateReasons 屬性，且當對應條件變為 false 時，再移除 JobStateReason 物件，而不管 Print Job 的總體 JobState 是否也更改。

JobStateReasons 類別從 java.util.HashSet 類別繼承其實作。與大多數建構後不可變的列印屬性不同，我們把 JobStateReasons 類別設計為可變的，您可以將 JobStateReason 物件添加到現有 JobStateReasons 物件中，也可以再移除它們。但是，與 java.util.HashSet 類別一樣, JobStateReasons 類別不是多執行緒安全的。如果 JobStateReasons 物件將供多個執行緒使用，則要保證使其操作同步（例如，使用從 java.util.Collections 類別獲取的同步 set 視圖）。

IPP 相容性：每個單個 JobStateReason 物件的 toString() 方法所返回的字元串值給出了 IPP 關鍵字值。getName() 所返回的類別別名稱給出了 IPP 屬性名稱。

另請參見：

序列化表格

建構子摘要

JobStateReasons()
建構新的空作業狀態原因屬性；底層雜湊集合具有預設的初始容量和載入因子。

JobStateReasons(Collection<JobStateReason> collection)
建構新的作業狀態原因屬性，它包含與給定集合相同的 JobStateReason 物件。

JobStateReasons(int initialCapacity)
建構新的空作業狀態原因屬性；底層雜湊集合具有給定的初始容量和預設的載入因子。

JobStateReasons(int initialCapacity, float loadFactor)
建構新的空作業狀態原因屬性；底層雜湊集合具有給定的容量和載入因子。

方法摘要

boolean	add(JobStateReason o) 將指定的元素添加到此作業狀態原因屬性（如果它尚未存在）。
Class<? extends Attribute>	getCategory() 獲取將被用作此列印屬性值的“類別別”的列印屬性類別。
String	getName() 獲取類別別名稱，此屬性值為該類別別的實例。

從類別 java.util.HashSet 繼承的方法

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

從類別 java.util.AbstractSet 繼承的方法

equals, hashCode, removeAll

從類別 java.util.AbstractCollection 繼承的方法

addAll, containsAll, retainAll, toArray, toArray, toString

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

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

從介面 java.util.Set 繼承的方法

addAll, containsAll, equals, hashCode, 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 為 null，或 collection 中任何元素為 null，則拋出此異常。

ClassCastException - （未檢查的異常）如果 collection 中任何元素不是 JobStateReason 類別的實例，則拋出此異常。

方法詳細資訊

add

public boolean add(JobStateReason o)

將指定的元素添加到此作業狀態原因屬性（如果它尚未存在）。要添加的元素必須為 JobStateReason 類別的實例。如果此作業狀態原因屬性已經包含指定的元素，則該調用不改變此作業狀態原因屬性並返回 false。

指定者：

介面 Collection<JobStateReason> 中的 add

指定者：

介面 Set<JobStateReason> 中的 add

覆寫：

類別 HashSet<JobStateReason> 中的 add

參數：

o - 將要添加到此作業狀態原因屬性中的元素。

返回：

如果此作業狀態原因屬性不包含指定的元素，則返回 true。

拋出：

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

ClassCastException - （未檢查的異常）如果指定的元素不是 JobStateReason 類別的實例，則拋出此異常。

從以下版本開始：

1.5

getCategory

public final Class<? extends Attribute> getCategory()

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

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

指定者：

介面 Attribute 中的 getCategory

返回：

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

getName

public final String getName()

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

對於 JobStateReasons 類別，類別別名稱為 "job-state-reasons"。

指定者：

介面 Attribute 中的 getName

返回：

屬性類別別名稱。