AttributeSet (Java Platform SE 8 )

All Known Subinterfaces:

DocAttributeSet ， PrintJobAttributeSet ， PrintRequestAttributeSet ， PrintServiceAttributeSet

所有已知实现类：

HashAttributeSet ， HashDocAttributeSet ， HashPrintJobAttributeSet ， HashPrintRequestAttributeSet ， HashPrintServiceAttributeSet
```
public interface AttributeSet
```
Interface AttributeSet指定一组打印属性的接口。打印属性是类实现接口Attribute的对象。
属性集包含一组属性值，其中集合中不允许重复的值。此外，属性集中的每个值都是某个类别的成员，并且在该集合中允许任何特定类别中的最多一个值。对于属性集，值为Attribute对象，类别为类对象。属性类别是该类属性的类层次结构根目录下的类（或接口）。请注意，属性对象的类别可能是属性对象的类的超类，而不是属性对象的类本身。属性对象的类别是通过调用确定getCategory()在接口中定义的方法Attribute 。

AttributeSet的接口类似于Java Collections API的java.util.Map接口的接口，但是它将接受的类型更具限制性，并将键和值组合到一个Attribute中。

属性集在Print Service API的多个位置使用。在每个上下文中，只有某些种类的属性被允许出现在该属性集，如由该属性类实现加标签接口确定- DocAttribute ， PrintRequestAttribute ， PrintJobAttribute和PrintServiceAttribute 。但是也有一些限制为仅包含四种属性的一个属性组四个特- DocAttributeSet ， PrintRequestAttributeSet ， PrintJobAttributeSet和PrintServiceAttributeSet ，分别。请注意，许多属性类实现多个标记接口，因此可能会出现在多个上下文中。
- 甲DocAttributeSet ，含有DocAttribute个 S，指定单个文档和所述打印作业设置的特性，以被应用到一个单独的文档。
- 一个PrintRequestAttributeSet ，含PrintRequestAttribute个 S，指定设置应用到整个打印作业，并在打印作业中所有文档。
- A PrintJobAttributeSet ，包含PrintJobAttribute s，报告打印作业的状态。
- A PrintServiceAttributeSet ，包含PrintServiceAttribute s，报告打印服务实例的状态。
在某些情况下，只允许客户端检查属性集的内容，但不允许更改它们（该集合是只读的）。在其他地方，允许客户端检查和更改属性集的内容（集合是读写）。对于只读属性集，调用mutating操作会引发UnmodifiableSetException。

Print Service API提供了一个接口AttributeSet的实现，类别为HashAttributeSet 。客户端可以使用类别HashAttributeSet或提供自己的接口AttributeSet的实现。打印服务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()` 如果此属性集不包含任何属性，则返回true。
`boolean`	`remove(Attribute attribute)` 从该属性集中删除指定的属性（如果存在）。
`boolean`	`remove(类<?> category)` 从此属性集中删除此类别的任何属性（如果存在）。
`int`	`size()` 返回此属性集中的属性数。
`Attribute[]`	`toArray()` 返回此集合中包含的属性的数组。

- 方法详细信息
  - get
```
Attribute get(类<?> category)
```
    返回此属性集在给定属性类别中包含的属性值。如果此属性集不包含给定属性类别中的任何属性值，则返回null 。
    
    参数
    
    category - 要返回其关联属性值的属性类别。它必须是类实现接口Attribute 。
    
    结果
    
    此属性中包含给定属性类别中的属性值，或 null如果此属性集不包含给定的属性类别中的任何属性值。
    
    异常
    
    NullPointerException - （未选中的异常）如果 category为空，则抛出。
    
    ClassCastException - （未经检查的异常）如果category不是实现接口Attribute的类 ，则抛出。
  - add
```
boolean add(Attribute attribute)
```
    如果指定的属性不存在，请将指定的属性添加到此属性集中，首先删除与指定的属性值相同的属性类别中的任何现有值。
    
    参数
    
    attribute - 要添加到此属性集的属性值。
    
    结果
    
    true如果该属性集作为调用的结果发生更改，即给定的属性值不是此属性集的成员。
    
    异常
    
    NullPointerException - （未经检查的异常）如果 attribute为空，则抛出。
    
    UnmodifiableSetException - （未经检查的异常）如果此属性集不支持 add()操作。
  - remove
```
boolean remove(类<?> category)
```
    从此属性集中删除此类别的任何属性（如果存在）。如果category为空，则remove()不执行任何操作并返回false 。
    
    参数
    
    category - 要从此属性集中删除的属性类别。
    
    结果
    
    true如果此属性集由于调用而更改，即给定的属性值已成为此属性集的成员。
    
    异常
    
    UnmodifiableSetException - （未经检查的异常）如果此属性集不支持 remove()操作。
  - remove
```
boolean remove(Attribute attribute)
```
    从该属性集中删除指定的属性（如果存在）。如果attribute为空，则remove()不执行任何操作并返回false 。
    
    参数
    
    attribute - 要从此属性集中删除的属性值。
    
    结果
    
    true如果此属性集作为调用的结果而更改，即给定的属性值已成为此属性集的成员。
    
    异常
    
    UnmodifiableSetException - （未经检查的异常）如果此属性集不支持 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 - （未检查异常）如果此属性集不支持 addAll(AttributeSet)方法，则抛出此异常。
    
    NullPointerException - （未检查的异常）如果指定集合中的某些元素为空，则抛出。
    
    另请参见：
    
    add(Attribute)
  - size
```
int size()
```
    返回此属性集中的属性数。如果此属性集包含超过Integer.MAX_VALUE个元素，则返回Integer.MAX_VALUE 。
    
    结果
    
    此属性集中的属性数。
  - toArray
```
Attribute[] toArray()
```
    返回此集合中包含的属性的数组。
    
    结果
    
    该集合中包含的属性为数组，如果AttributeSet为空，则为零长度。
  - clear
```
void clear()
```
    从该属性集中删除所有属性。
    
    异常
    
    UnmodifiableSetException - （未经检查的异常）如果此属性集不支持 clear()操作。
  - isEmpty
```
boolean isEmpty()
```
    如果此属性集不包含任何属性，则返回true。
    
    结果
    
    如果此属性集不包含属性，则为true。
  - 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