compact1, compact2, compact3

java.text

Class AttributedString

java.lang.Object

java.text.AttributedString

public class AttributedString
extends Object

一个attributedstring包含文本和相关的属性信息。它可以用在一些情况下，文本阅读器要访问属性的文本通过attributedcharacteriterator接口的实际数据存储。

属性是一个键/值对，由键确定。在一个给定的字符上没有两个属性可以有相同的键。

属性的值是不可变的，也不能由客户端或存储发生突变。他们总是通过参考，而不是克隆。

从以下版本开始：

一点二

另请参见：

AttributedCharacterIterator， Annotation

构造方法摘要

构造方法

Constructor and Description
AttributedString(AttributedCharacterIterator text) 构建了一个attributedstring实例与给定的属性的文本表示的attributedcharacteriterator。
AttributedString(AttributedCharacterIterator text, int beginIndex, int endIndex) 构建了一个attributedstring实例与给定的属性的文本表示的attributedcharacteriterator终端。
AttributedString(AttributedCharacterIterator text, int beginIndex, int endIndex, AttributedCharacterIterator.Attribute[] attributes) 构建了一个attributedstring实例与给定的属性的文本表示的attributedcharacteriterator终端。
AttributedString(String text) 构建了一个attributedstring实例与给定的文本。
AttributedString(String text, Map<? extends AttributedCharacterIterator.Attribute,?> attributes) 构建了一个attributedstring实例与给定的文本和属性。

方法摘要

Modifier and Type	Method and Description
void	addAttribute(AttributedCharacterIterator.Attribute attribute, Object value) 向整个字符串添加一个属性。
void	addAttribute(AttributedCharacterIterator.Attribute attribute, Object value, int beginIndex, int endIndex) 将属性添加到的子字符串。
void	addAttributes(Map<? extends AttributedCharacterIterator.Attribute,?> attributes, int beginIndex, int endIndex) 将一组属性的一部分的字符串。
AttributedCharacterIterator	getIterator() 创建一个attributedcharacteriterator实例提供了访问此字符串的全部内容。
AttributedCharacterIterator	getIterator(AttributedCharacterIterator.Attribute[] attributes) 创建一个attributedcharacteriterator实例提供了访问该字符串所选择的内容。
AttributedCharacterIterator	getIterator(AttributedCharacterIterator.Attribute[] attributes, int beginIndex, int endIndex) 创建一个attributedcharacteriterator实例提供了访问该字符串所选择的内容。

Methods inherited from class java.lang.Object

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

Constructor Detail

AttributedString

public AttributedString(String text)

构建了一个attributedstring实例与给定的文本。

参数

text -这个属性字符串文本。

异常

NullPointerException -如果 text是空的。

AttributedString

public AttributedString(String text,
                        Map<? extends AttributedCharacterIterator.Attribute,?> attributes)

构建了一个attributedstring实例与给定的文本和属性。

参数

text -这个属性字符串文本。

attributes -应用于整个字符串的属性。

异常

NullPointerException -如果 text或 attributes是空的。

IllegalArgumentException -如果文本长度为0和属性参数不是一个空洞的Map（属性不能应用于一个长度为0的范围）。

AttributedString

public AttributedString(AttributedCharacterIterator text)

构建了一个attributedstring实例与给定的属性的文本表示的attributedcharacteriterator。

参数

text -这个属性字符串文本。

异常

NullPointerException -如果 text是空的。

AttributedString

public AttributedString(AttributedCharacterIterator text,
                        int beginIndex,
                        int endIndex)

构建了一个attributedstring实例与给定的属性的文本表示的attributedcharacteriterator终端。如果给定的范围产生一个空文本，所有的属性将被丢弃。请注意，任何属性的注释对象包裹是一部分的原始属性范围丢弃。

参数

text -这个属性字符串文本。

beginIndex -范围的第一个字符索引。

endIndex的字符索引以下范围的最后一个字符。

异常

NullPointerException -如果 text是空的。

IllegalArgumentException beginIndex和endIndex如果给定的子范围的文本范围。

另请参见：

Annotation

AttributedString

public AttributedString(AttributedCharacterIterator text,
                        int beginIndex,
                        int endIndex,
                        AttributedCharacterIterator.Attribute[] attributes)

构建了一个attributedstring实例与给定的属性的文本表示的attributedcharacteriterator终端。只有匹配给定属性的属性将被合并到实例中。如果给定的范围产生一个空文本，所有的属性将被丢弃。请注意，任何属性的注释对象包裹是一部分的原始属性范围丢弃。

参数

text -这个属性字符串文本。

beginIndex -范围的第一个字符索引。

endIndex的字符索引以下范围的最后一个字符。

attributes -指定属性是从文本中提取。如果指定了空，所有可用的属性将被使用。

异常

NullPointerException -如果 text是空的。

IllegalArgumentException beginIndex和endIndex如果给定的子范围的文本范围。

另请参见：

Annotation

方法详细信息

addAttribute

public void addAttribute(AttributedCharacterIterator.Attribute attribute,
                         Object value)

向整个字符串添加一个属性。

参数

attribute -属性的关键

value -该属性的值可以为空；

异常

NullPointerException -如果 attribute是空的。

IllegalArgumentException -如果attributedstring长度为0（属性不能应用于一个长度为0的范围）。

addAttribute

public void addAttribute(AttributedCharacterIterator.Attribute attribute,
                         Object value,
                         int beginIndex,
                         int endIndex)

将属性添加到的子字符串。

参数

attribute -属性的关键

value -该属性的值。可能是空的。

beginIndex -范围的第一个字符索引。

endIndex的字符索引以下范围的最后一个字符。

异常

NullPointerException -如果 attribute是空的。

IllegalArgumentException如果beginIndex小于0，指定大于字符串的长度，或beginIndex和endIndex一起不定义一个非空的子字符串。

addAttributes

public void addAttributes(Map<? extends AttributedCharacterIterator.Attribute,?> attributes,
                          int beginIndex,
                          int endIndex)

将一组属性的一部分的字符串。

参数

attributes -被添加到字符串的属性。

beginIndex -范围的第一个字符索引。

endIndex的字符索引以下范围的最后一个字符。

异常

NullPointerException -如果 attributes是空的。

IllegalArgumentException如果beginIndex小于0，指定大于字符串的长度，或beginIndex和endIndex一起不定义一个非空的子字符串和属性参数不是一个空洞的Map。

getIterator

public AttributedCharacterIterator getIterator()

创建一个attributedcharacteriterator实例提供了访问此字符串的全部内容。

结果

提供对文本的访问和它的属性的迭代器。

getIterator

public AttributedCharacterIterator getIterator(AttributedCharacterIterator.Attribute[] attributes)

创建一个attributedcharacteriterator实例提供了访问该字符串所选择的内容。信息的属性中未列出的属性的实现者可能不需通过迭代器访问。如果列表是空的，所有可用的属性信息都应该是可访问的。

参数

attributes -目录，用户感兴趣的属性

结果

提供对整个文本和它所选择的属性的访问的迭代器

getIterator

public AttributedCharacterIterator getIterator(AttributedCharacterIterator.Attribute[] attributes,
                                               int beginIndex,
                                               int endIndex)

创建一个attributedcharacteriterator实例提供了访问该字符串所选择的内容。信息的属性中未列出的属性的实现者可能不需通过迭代器访问。如果列表是空的，所有可用的属性信息都应该是可访问的。

参数

attributes -目录，用户感兴趣的属性

beginIndex -第一个字符的索引

endIndex -最后一个字符后的字符的索引

结果

提供对文本的访问和它的属性的迭代器

异常

IllegalArgumentException如果beginIndex小于0，指定大于字符串的长度，或beginIndex大于endIndex。