java.text
类 AttributedString

java.lang.Object
  java.text.AttributedString

public class AttributedString
extends Object

AttributedString 保存文本及相关属性信息。在文本阅读器希望通过 AttributedCharacterIterator 接口访问属性文本的情况下，它可用于存储实际数据。

从以下版本开始：

1.2

另请参见：

AttributedCharacterIterator, Annotation

构造方法摘要

AttributedString(AttributedCharacterIterator text)
用给定的 AttributedCharacterIterator 表示的属性文本构造一个 AttributedString。

AttributedString(AttributedCharacterIterator text, int beginIndex, int endIndex)
用给定的 AttributedCharacterIterator 表示的属性文本的子范围构造一个 AttributedString。

AttributedString(AttributedCharacterIterator text, int beginIndex, int endIndex, AttributedCharacterIterator.Attribute[] attributes)
用给定的 AttributedCharacterIterator 表示的属性文本的子范围构造一个 AttributedString。

AttributedString(String text)
构造带给定文本的 AttributedString 实例。

AttributedString(String text, Map<? extends AttributedCharacterIterator.Attribute,?> attributes)
构造带给定文本和属性的 AttributedString。

方法摘要

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 实例，提供对字符串选定内容的访问。

从类 java.lang.Object 继承的方法

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

构造方法详细信息

AttributedString

public AttributedString(String text)

构造带给定文本的 AttributedString 实例。

参数：

text - 此属性字符串的文本。

AttributedString

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

构造带给定文本和属性的 AttributedString。

参数：

text - 此属性字符串的文本。

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

抛出：

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

AttributedString

public AttributedString(AttributedCharacterIterator text)

用给定的 AttributedCharacterIterator 表示的属性文本构造一个 AttributedString。

参数：

text - 此属性字符串的文本。

AttributedString

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

用给定的 AttributedCharacterIterator 表示的属性文本的子范围构造一个 AttributedString。如果给定的范围产生一个空文本，所有的属性将被丢弃。注意，对于初始属性范围的子范围，Annotation 对象包装的任何属性都被丢弃。

参数：

text - 此属性字符串的文本。

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

endIndex - 范围最后一个字符之后紧邻字符的索引。

抛出：

IllegalArgumentException - 如果 beginIndex 和 endIndex 指定的子范围超出文本范围。

另请参见：

Annotation

AttributedString

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

用给定的 AttributedCharacterIterator 表示的属性文本的子范围构造一个 AttributedString。只有属性与给定的属性匹配时才被合并进该实例。如果指定的范围产生一个空文本，所有的属性将被丢弃。注意，对于初始属性范围的子范围，Annotation 对象包装的任何属性都被丢弃。

参数：

text - 此属性字符串的文本。

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

endIndex - 范围最后一个字符之后紧邻字符的索引。

attributes - 指定要从文本中提取出来的属性。如果指定为 null，则用到所有可用属性。

抛出：

IllegalArgumentException - 如果 beginIndex 和 endIndex 指定的子范围超出文本范围。

另请参见：

Annotation

方法详细信息

addAttribute

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

将一个属性添加到整个字符串中。

参数：

attribute - 属性键

value - 属性值；可以为 null

抛出：

IllegalArgumentException - 如果 AttributedString 长度为 0（属性不能应用于 0 长度范围文本）。

addAttribute

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

将一个属性添加到字符串的子范围。

参数：

attribute - 属性键

value - 属性值。可以为 null。

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

endIndex - 范围最后一个字符之后紧邻字符的索引。

抛出：

IllegalArgumentException - 如果 beginIndex 小于 0，endIndex 大于字符串的长度，或者 beginIndex 和 endIndex 一起未定义字符串的非空子范围。

addAttributes

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

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

参数：

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

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

endIndex - 范围最后一个字符之后紧邻字符的索引。

抛出：

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

getIterator

public AttributedCharacterIterator getIterator()

构造一个 AttributedCharacterIterator 实例，提供对整个字符串内容的访问。

返回：

提供访问文本及其属性的迭代器。

getIterator

public AttributedCharacterIterator getIterator(AttributedCharacterIterator.Attribute[] attributes)

构造一个 AttributedCharacterIterator 实例，提供对字符串选定内容的访问。实现者不必让没有列于属性中的属性信息通过迭代器可访问。如果列表为 null，则应该让所有可用的属性信息都可访问。

参数：

attributes - 客户感兴趣的属性列表

返回：

提供访问文本及其属性的迭代器

getIterator

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

构造一个 AttributedCharacterIterator 实例，提供对字符串选定内容的访问。实现者不必让没有列于属性中的属性信息通过迭代器可访问。如果列表为 null，则应该让所有可用的属性信息都可访问。

参数：

attributes - 客户感兴趣的属性列表

beginIndex - 第一个字符的索引

endIndex - 最后一个字符之后紧邻字符的索引

返回：

提供访问文本及其属性的迭代器

抛出：

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