javax.print.attribute
類別 HashAttributeSet

java.lang.Object
  javax.print.attribute.HashAttributeSet

所有已實作的介面：

Serializable, AttributeSet

直接已知子類別：

HashDocAttributeSet, HashPrintJobAttributeSet, HashPrintRequestAttributeSet, HashPrintServiceAttributeSet

public class HashAttributeSet
extends Object
implements AttributeSet, Serializable

類別 HashAttributeSet 提供具有雜湊映射特徵的 AttributeSet 實作。

另請參見：

序列化表格

建構子摘要

	HashAttributeSet() 建構一個新的、空屬性集。
	HashAttributeSet(Attribute attribute) 建構一個最初使用給定屬性填充的新屬性集。
	HashAttributeSet(Attribute[] attributes) 建構一個最初使用給定陣列中的值填充的新屬性集。
protected	HashAttributeSet(Attribute[] attributes, Class<?> interfaceName) 建構一個新的屬性集，其中該屬性集的成員限於給定的介面。
protected	HashAttributeSet(Attribute attribute, Class<?> interfaceName) 建構一個最初使用給定屬性填充的新屬性集，其中該屬性集的成員限於給定的介面。
	HashAttributeSet(AttributeSet attributes) 建構一個最初使用給定集合中的值填充的新屬性集。
protected	HashAttributeSet(AttributeSet attributes, Class<?> interfaceName) 建構一個最初使用給定集合中的值填充的新屬性集，其中該屬性集的成員限於給定的介面。
protected	HashAttributeSet(Class<?> interfaceName) 建構一個新的空屬性集，其中該屬性集的成員限於給定的介面。

方法摘要

boolean	add(Attribute attribute) 如果指定的屬性不存在，則將它添加到此屬性集中，方法是首先移除與指定屬性值相同的屬性類別別中的任何現有屬性。
boolean	addAll(AttributeSet attributes) 將指定集合中的所有元素添加到此屬性中。
void	clear() 從此屬性集中移除所有屬性。
boolean	containsKey(Class<?> category) 如果此屬性集包含指定類別別的屬性，則返回 true。
boolean	containsValue(Attribute attribute) 如果此屬性集包含給定的屬性，則返回 true。
boolean	equals(Object object) 比較指定的物件與此屬性集的相等性。
Attribute	get(Class<?> category) 返回此屬性集在給定的屬性類別別中包含的屬性值。
int	hashCode() 返回此屬性集的雜湊碼值。
boolean	isEmpty() 如果此屬性集不包含任何屬性，則返回 true。
boolean	remove(Attribute attribute) 從此屬性集移除指定的屬性（如果存在）。
boolean	remove(Class<?> category) 從此屬性集移除此類別別的任何屬性（如果存在）。
int	size() 返回此屬性集中屬性的數量。
Attribute[]	toArray() 返回此集合中包含的屬性的陣列。

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

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

HashAttributeSet

public HashAttributeSet()

建構一個新的、空屬性集。

HashAttributeSet

public HashAttributeSet(Attribute attribute)

建構一個最初使用給定屬性填充的新屬性集。

參數：

attribute - 要添加到此集合的屬性值。

拋出：

NullPointerException - （未經檢查的異常）如果 attribute 為 null，則拋出該異常。

HashAttributeSet

public HashAttributeSet(Attribute[] attributes)

建構一個最初使用給定陣列中的值填充的新屬性集。通過將 attributes 陣列中的元素從索引 0 開始按順序添加到該集合來填充新的屬性集。因此，如果該陣列包含重複的屬性值或屬性類別別，則後面的陣列元素可以替換前面的陣列元素。

參數：

attributes - 要添加到該集合的屬性值的陣列。如果為 null，則建構一個空屬性集。

拋出：

NullPointerException - （未經檢查的異常）如果 attributes 的任何元素為 null，則拋出該異常。

HashAttributeSet

public HashAttributeSet(AttributeSet attributes)

建構一個最初使用給定集合中的值填充的新屬性集。

參數：

attributes - 從中初始化此集合的屬性集。如果為 null，則建構一個空屬性集。

HashAttributeSet

protected HashAttributeSet(Class<?> interfaceName)

建構一個新的空屬性集，其中該屬性集的成員限於給定的介面。

參數：

interfaceName - 此屬性集的所有成員必須是其實例的介面。假設是介面 Attribute 或其子介面。

拋出：

NullPointerException - 如果 interfaceName 為 null。

HashAttributeSet

protected HashAttributeSet(Attribute attribute,
                           Class<?> interfaceName)

建構一個最初使用給定屬性填充的新屬性集，其中該屬性集的成員限於給定的介面。

參數：

attribute - 要添加到此集合的屬性值。

interfaceName - 此屬性集的所有成員必須是其實例的介面。假設是介面 Attribute 或其子介面。

拋出：

NullPointerException - （未經檢查的異常）如果 attribute 為 null，則拋出該異常。

NullPointerException - 如果 interfaceName 為 null。

ClassCastException - （未經檢查的異常）如果 attribute 不是 interfaceName 的一個實例，則拋出該異常。

HashAttributeSet

protected HashAttributeSet(Attribute[] attributes,
                           Class<?> interfaceName)

建構一個新的屬性集，其中該屬性集的成員限於給定的介面。通過將 attributes 陣列中的元素從索引 0 開始按順序添加到該集合來填充新的屬性集。因此，如果該陣列包含重複的屬性值或屬性類別別，則後面的陣列元素可以替換前面的陣列元素。

參數：

attributes - 要添加到該集合的屬性值的陣列。如果為 null，則建構一個空屬性集。

interfaceName - 此屬性集的所有成員必須是其實例的介面。假設是介面 Attribute 或其子介面。

拋出：

NullPointerException - （未經檢查的異常）如果 attributes 的任何元素為 null，則拋出該異常。

NullPointerException - 如果 interfaceName 為 null。

ClassCastException - （未經檢查的異常）如果 attributes 的元素不是 interfaceName 的一個實例，則拋出該異常。

HashAttributeSet

protected HashAttributeSet(AttributeSet attributes,
                           Class<?> interfaceName)

建構一個最初使用給定集合中的值填充的新屬性集，其中該屬性集的成員限於給定的介面。

參數：

attributes - 要初始化該集合的屬性值的集合。如果為 null，則建構一個空屬性集。

interfaceName - 此屬性集的所有成員必須是其實例的介面。假設是介面 Attribute 或其子介面。

拋出：

ClassCastException - （未經檢查的異常）如果 attributes 的元素不是 interfaceName 的一個實例，則拋出該異常。

方法詳細資訊

get

public Attribute get(Class<?> category)

返回此屬性集在給定的屬性類別別中包含的屬性值。如果此屬性集在給定的屬性類別別中不包含任何屬性值，則返回 null。

指定者：

介面 AttributeSet 中的 get

參數：

category - 將返回其關聯的屬性值的屬性類別別。它必須是實作介面 Attribute 的 Class。

返回：

此屬性集中包含的給定屬性類別別中的屬性值，如果此屬性集在給定的屬性類別別中不包含任何屬性值，則返回 null。

拋出：

NullPointerException - （未經檢查的異常）如果 category 為 null，則拋出該異常。

ClassCastException - （未經檢查的異常）如果 category 不是實作介面 Attribute 的 Class，則拋出該異常。

add

public boolean add(Attribute attribute)

如果指定的屬性不存在，則將它添加到此屬性集中，方法是首先移除與指定屬性值相同的屬性類別別中的任何現有屬性。

指定者：

介面 AttributeSet 中的 add

參數：

attribute - 要添加到此屬性集的屬性值。

返回：

如果此屬性集由於調用而發生改變（即：給定的屬性值還不是此屬性集的成員），則返回 true。

拋出：

NullPointerException - （未經檢查的異常）如果 attribute 為 null，則拋出該異常。

UnmodifiableSetException - （未經檢查的異常）如果此屬性集不支持 add() 操作，則拋出該異常。

remove

public boolean remove(Class<?> category)

從此屬性集移除此類別別的任何屬性（如果存在）。如果 category 為 null，則 remove() 不執行任何操作，並返回 false。

指定者：

介面 AttributeSet 中的 remove

參數：

category - 要從此屬性集移除的屬性類別別。

返回：

如果此屬性集由於調用而發生改變（即給定的屬性類別別已經成為此屬性集的成員），則返回 true。

拋出：

UnmodifiableSetException - （未經檢查的異常）如果此屬性集不支持 remove() 操作，則拋出該異常。

remove

public boolean remove(Attribute attribute)

從此屬性集移除指定的屬性（如果存在）。如果 attribute 為 null，則 remove() 不執行任何操作，並返回 false。

指定者：

介面 AttributeSet 中的 remove

參數：

attribute - 從此屬性集移除的屬性值。

返回：

如果此屬性集由於調用而發生改變（即：給定的屬性值已經成為此屬性集的成員），則返回 true。

拋出：

UnmodifiableSetException - （未經檢查的異常）如果此屬性集不支持 remove() 操作，則拋出該異常。

containsKey

public boolean containsKey(Class<?> category)

如果此屬性集包含指定類別別的屬性，則返回 true。

指定者：

介面 AttributeSet 中的 containsKey

參數：

category - 將測試其是否存在於此屬性集中的類別別。

返回：

如果此屬性集包含指定類別別的一個屬性值，則返回 true。

containsValue

public boolean containsValue(Attribute attribute)

如果此屬性集包含給定的屬性，則返回 true。

指定者：

介面 AttributeSet 中的 containsValue

參數：

attribute - 將測試其是否存在於此屬性集中的值。

返回：

如果此屬性集包含給定的屬性值，則返回 true。

addAll

public boolean addAll(AttributeSet attributes)

將指定集合中的所有元素添加到此屬性中。該結果與使用指定集合中的每個元素將 add(Attribute) 操作成功地應用到此屬性集中相同。如果正在進行此操作的同時修改了指定的集合，則 addAll(AttributeSet) 操作的行為是不確定的。

如果 addAll(AttributeSet) 操作拋出一個異常，則對此屬性集狀態的影響取決於實作方法；在異常點之前，不一定將指定集合中的元素添加到了此屬性集。

指定者：

介面 AttributeSet 中的 addAll

參數：

attributes - 要將其元素添加到此屬性集中的屬性。

返回：

如果此屬性集由於調用而發生改變，則返回 true。

拋出：

UnmodifiableSetException - （未經檢查的異常）如果此屬性集不支持 addAll(AttributeSet) 方法，則拋出該異常。

NullPointerException - （未經檢查的異常）如果指定集合中的某一元素為 null，或該集合為 null，則拋出該異常。

另請參見：

add(Attribute)

size

public int size()

返回此屬性集中屬性的數量。如果此屬性集包含的元素多於 Integer.MAX_VALUE ，則返回 Integer.MAX_VALUE。

指定者：

介面 AttributeSet 中的 size

返回：

此屬性集中屬性的數量。

toArray

public Attribute[] toArray()

從介面 AttributeSet 複製的描述

返回此集合中包含的屬性的陣列。

指定者：

介面 AttributeSet 中的 toArray

返回：

作為陣列包含在此集合中的屬性，如果 AttributeSet 為空，則返回零長度。

clear

public void clear()

從此屬性集中移除所有屬性。

指定者：

介面 AttributeSet 中的 clear

拋出：

UnmodifiableSetException - （未經檢查的異常）如果此屬性集不支持 clear() 操作，則拋出該異常。

isEmpty

public boolean isEmpty()

如果此屬性集不包含任何屬性，則返回 true。

指定者：

介面 AttributeSet 中的 isEmpty

返回：

如果此屬性集不包含任何屬性，則返回 true。

equals

public boolean equals(Object object)

比較指定的物件與此屬性集的相等性。如果給定的物件也是一個屬性集，並且兩個屬性集包含相同的屬性類別別到屬性值的映射關係，則返回 true。這確保了 equals() 方法能跨越 AttributeSet 介面的不同實作正常運行。

指定者：

介面 AttributeSet 中的 equals

覆寫：

類別 Object 中的 equals

參數：

object - 要與此屬性集進行相等性比較的物件。

返回：

如果指定物件等於此屬性集，則返回 true。

另請參見：

Object.hashCode(), Hashtable

hashCode

public int hashCode()

返回此屬性集的雜湊碼值。屬性集的雜湊碼被定義為 AttributeSet 中每個條目的雜湊碼的總和。這確保了 t1.equals(t2) 意味對於任何兩個屬性集 t1 和 t2 而言，都存在 t1.hashCode()==t2.hashCode()，這是 Object.hashCode() 的通用協定所要求的。

指定者：

介面 AttributeSet 中的 hashCode

覆寫：

類別 Object 中的 hashCode

返回：

此屬性集的雜湊碼值。

另請參見：

Object.equals(java.lang.Object), Hashtable