AttributeSet (Java Platform SE 8 )

All Known Subinterfaces:

DocAttributeSet， PrintJobAttributeSet， PrintRequestAttributeSet， PrintServiceAttributeSet

所有已知实现类：

HashAttributeSet， HashDocAttributeSet， HashPrintJobAttributeSet， HashPrintRequestAttributeSet， HashPrintServiceAttributeSet
```
public interface AttributeSet
```
接口attributeset指定一组打印属性界面。打印属性的类实现了接口 Attribute对象。
一个属性集包含一组属性值，其中重复的值不在设定的允许。此外，在属性集的每个值有一定的类别成员，和至多一个价值在任何特定的类中设置允许。一个属性设置的值，Attribute对象和类别类对象。属性的类别是类（或接口）在类层次结构的根类属性的类（或接口）类。注意，属性对象的类可能是一个父类的属性对象的类而不是对象本身的属性。属性对象的类是通过调用接口中定义的方法确定Attribute getCategory()。

一个attributeset接口类似于java集合API的java.util.map接口，但更多的是限制性的类型，它会接受，并结合键和值到一个属性。

属性集在打印服务应用接口的几个地方使用。在每一种情况下，只有某些种类的属性可以出现在属性集，由标记的属性类实现了接口，DocAttribute，PrintRequestAttribute，PrintJobAttribute，和PrintServiceAttribute确定。有四个专业的属性集被限制为只包含一个属性的四种——DocAttributeSet，PrintRequestAttributeSet，PrintJobAttributeSet，和PrintServiceAttributeSet，分别。请注意，许多属性类实现了一个以上的标记接口，因此可能会出现在多个上下文中。
- 一个DocAttributeSet，含DocAttributes，指定要应用到单个文件的个人文档和打印作业设置的特点。
- 一个PrintRequestAttributeSet，含PrintRequestAttributes，指定要应用到整个打印工作，在打印作业的所有文档的设置。
- 一个PrintJobAttributeSet，含PrintJobAttributes，报告的打印作业的状态。
- 一个PrintServiceAttributeSet，含PrintServiceAttributes、报告打印服务实例的状态。
在某些情况下，客户端只允许检查属性集的内容，但不改变它们（该集合是只读的）。在其他地方，客户端允许检查和改变一个属性集的内容（设置读写）。一个只读属性，调用一个变异操作引发unmodifiablesetexception。

打印服务API提供了一个实现类接口attributeset，HashAttributeSet。一个客户端可以使用类或接口attributeset HashAttributeSet提供它自己的实现。打印服务API还提供了实现接口的子接口，类attributeset HashDocAttributeSet，HashPrintRequestAttributeSet，HashPrintJobAttributeSet，和HashPrintServiceAttributeSet。

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`boolean`	`add(Attribute attribute)` 如果没有已存在，则将指定的属性添加到该属性集中，首先将在同一属性类别中的任何现有值作为指定的属性值。
`boolean`	`addAll(AttributeSet attributes)` 将指定的集合中的所有元素添加到这个属性中。
`void`	`clear()` 从这个属性集中移除所有的属性。
`boolean`	`containsKey(类<?> category)` 返回 `true`如果这个属性集包含指定的类别属性。
`boolean`	`containsValue(Attribute attribute)` 如果此属性设置 `true`返回包含给定属性值。
`boolean`	`equals(Object object)` 将指定的对象与此属性设置为相等。
`Attribute`	`get(类<?> category)` 返回此属性集包含的属性值在给定的属性类别中的属性值。
`int`	`hashCode()` 返回此属性集的哈希代码值。
`boolean`	`isEmpty()` 如果此属性集不包含任何属性，则返回真。
`boolean`	`remove(Attribute attribute)` 如果存在的话，从该属性集中移除指定的属性。
`boolean`	`remove(类<?> category)` 如果存在的话，从这个属性设置这个类别的任何属性。
`int`	`size()` 返回此属性集的属性的数目。
`Attribute[]`	`toArray()` 返回此集合中包含的属性的数组。

- 方法详细信息
  - get
```
Attribute get(类<?> category)
```
    返回此属性集包含的属性值在给定的属性类别中的属性值。返回 null如果该属性集不包含在给定的属性类的任何属性值。
    
    参数
    
    category属性类的相关属性值被返回。它必须是一个 类实现接口 Attribute。
    
    结果
    
    属性值在给定的属性范畴中的属性集，或 null如果该属性集不包含在给定的属性类的任何属性值。
    
    异常
    
    NullPointerException -（unchecked例外）如果 category空抛。
    
    ClassCastException -（unchecked例外）如果 category不是 类实现接口 Attribute扔。
  - add
```
boolean add(Attribute attribute)
```
    如果没有已存在，则将指定的属性添加到该属性集中，首先将在同一属性类别中的任何现有值作为指定的属性值。
    
    参数
    
    attribute属性值被添加到这个属性设置。
    
    结果
    
    如果此属性设置 true改变调用的结果，即，给定的属性值是没有这个属性的成员集。
    
    异常
    
    NullPointerException -（unchecked例外）如果 attribute空抛。
    
    UnmodifiableSetException -（unchecked异常）如果这个属性设置不支持 add()操作抛出。
  - remove
```
boolean remove(类<?> category)
```
    如果存在的话，从这个属性设置这个类别的任何属性。如果 category是空的，然后 remove()不返回 false。
    
    参数
    
    category属性范畴是删除从这个属性设置。
    
    结果
    
    如果此属性设置 true改变调用的结果，即，给定的属性值被该属性集的成员。
    
    异常
    
    UnmodifiableSetException -（unchecked异常）如果这个属性设置不支持 remove()操作抛出。
  - remove
```
boolean remove(Attribute attribute)
```
    如果存在的话，从该属性集中移除指定的属性。如果 attribute是空的，然后 remove()不返回 false。
    
    参数
    
    attribute属性值被删除从这个属性设置。
    
    结果
    
    如果此属性设置 true改变调用的结果，即，给定的属性值被该属性集的成员。
    
    异常
    
    UnmodifiableSetException -（unchecked异常）如果这个属性设置不支持 remove()操作抛出。
  - containsKey
```
boolean containsKey(类<?> category)
```
    返回 true如果这个属性集包含指定的类别属性。
    
    参数
    
    category的该属性集的存在是进行测试。
    
    结果
    
    true如果这个属性设置为指定的类包含一个属性值。
  - containsValue
```
boolean containsValue(Attribute attribute)
```
    如果此属性设置 true返回包含给定属性值。
    
    参数
    
    attribute属性值为该属性集的存在是进行测试。
    
    结果
    
    true如果该属性集包含给定属性值。
  - addAll
```
boolean addAll(AttributeSet attributes)
```
    将指定的集合中的所有元素添加到这个属性中。结果是如果= add(Attribute)操作已经被应用到该属性集的每个元素依次从指定的设置相同。如果指定的设置是在操作进行改性的 addAll(AttributeSet)操作行为是未定义的。
    如果addAll(AttributeSet)操作抛出异常，该属性集的状态的影响是依赖于实现的；元素从指定的集合点前的异常可能会或可能不会被添加到这个属性设置。
    
    参数
    
    attributes的元素被添加到这个属性设置。
    
    结果
    
    如果此属性设置 true改变调用的结果。
    
    异常
    
    UnmodifiableSetException -（unchecked异常）如果这个属性设置不支持 addAll(AttributeSet)方法引发。
    
    NullPointerException -（unchecked异常）如果在指定集合的一些元素是空抛。
    
    另请参见：
    
    add(Attribute)
  - size
```
int size()
```
    返回此属性集的属性的数目。如果该属性集包含多 Integer.MAX_VALUE元素，返回 Integer.MAX_VALUE。
    
    结果
    
    此属性集的属性数。
  - toArray
```
Attribute[] toArray()
```
    返回此集合中包含的属性的数组。
    
    结果
    
    在这一集包含的属性是一个数组，长度为零，如果attributeset是空的。
  - clear
```
void clear()
```
    从这个属性集中移除所有的属性。
    
    异常
    
    UnmodifiableSetException -（unchecked异常）如果这个属性设置不支持 clear()操作抛出。
  - isEmpty
```
boolean isEmpty()
```
    如果此属性集不包含任何属性，则返回真。
    
    结果
    
    如果此属性集不包含属性，则为真。
  - equals
```
boolean equals(Object object)
```
    将指定的对象与此属性设置为相等。返回 true如果给定的对象也是一个属性集和属性集包含两个相同的属性类别属性值映射。这确保了 equals()方法正常工作在attributeset接口的不同实现。
    
    重写：
    
    equals 方法重写，继承类 Object
    
    参数
    
    object -比较与此属性设置平等。
    
    结果
    
    true指定对象是否等于该属性集。
    
    另请参见：
    
    Object.hashCode()， HashMap
  - hashCode
```
int hashCode()
```
    返回此属性集的哈希代码值。一个属性集合的哈希码的定义是在attributeset对每个条目的散列码的总和。这确保 t1.equals(t2)意味着 t1.hashCode()==t2.hashCode()任何两属性集 t1和 t2，由 Object.hashCode()一般合同要求。
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    此属性集的哈希代码值。
    
    另请参见：
    
    Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface AttributeSet

方法摘要

方法详细信息

get

add

remove

remove

containsKey

containsValue

addAll

size

toArray

clear

isEmpty

equals

hashCode