|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.text.AttributedString
public class AttributedString
AttributedString 保存文本及相关属性信息。在文本 reader 希望通过 AttributedCharacterIterator 接口访问属性文本的情况下,它可用于存储实际数据。
属性是一个键/值对,由键来标识。给定字符上的两个属性不能有相同的键。
属性的值是不变的,或者必须由客户端或存储来更换。它们始终由引用来传递,但是不进行复制。
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 |
构造方法详细信息 |
---|
public AttributedString(String text)
text
- 此属性字符串的文本。
NullPointerException
- 如果
text
为 null。
public AttributedString(String text, Map<? extends AttributedCharacterIterator.Attribute,?> attributes)
text
- 此属性字符串的文本。
attributes
- 应用于整个字符串的属性。
NullPointerException
- 如果
text
或
attributes
为 null。
IllegalArgumentException
- 如果文本长度为 0 且属性参数不是一个空 Map(属性不能应用于 0 长度范围文本)。
public AttributedString(AttributedCharacterIterator text)
text
- 此属性字符串的文本。
NullPointerException
- 如果
text
为 null。
public AttributedString(AttributedCharacterIterator text, int beginIndex, int endIndex)
text
- 此属性字符串的文本。
beginIndex
- 该范围的第一个字符的索引。
endIndex
- 范围最后一个字符之后紧邻字符的索引。
NullPointerException
- 如果
text
为 null。
IllegalArgumentException
- 如果 beginIndex 和 endIndex 给出的子范围超出文本范围。
Annotation
public AttributedString(AttributedCharacterIterator text, int beginIndex, int endIndex, AttributedCharacterIterator.Attribute[] attributes)
text
- 此属性字符串的文本。
beginIndex
- 该范围的第一个字符的索引。
endIndex
- 范围最后一个字符之后紧邻字符的索引。
attributes
- 指定要从文本中提取出来的属性。如果指定为 null,则用到所有可用属性。
NullPointerException
- 如果
text
或
attributes
为 null。
IllegalArgumentException
- 如果 beginIndex 和 endIndex 给出的子范围超出文本范围。
Annotation
方法详细信息 |
---|
public void addAttribute(AttributedCharacterIterator.Attribute attribute, Object value)
attribute
- 属性键
value
- 属性值;可以为 null
NullPointerException
- 如果
attribute
为 null。
IllegalArgumentException
- 如果 AttributedString 长度为 0(属性不能应用于 0 长度范围文本)。
public void addAttribute(AttributedCharacterIterator.Attribute attribute, Object value, int beginIndex, int endIndex)
attribute
- 属性键
value
- 属性值。可以为 null。
beginIndex
- 该范围的第一个字符的索引。
endIndex
- 范围最后一个字符之后紧邻字符的索引。
NullPointerException
- 如果
attribute
为 null。
IllegalArgumentException
- 如果 beginIndex 小于 0,endIndex 大于字符串的长度,或者 beginIndex 和 endIndex 一起未定义字符串的非空子范围。
public void addAttributes(Map<? extends AttributedCharacterIterator.Attribute,?> attributes, int beginIndex, int endIndex)
attributes
- 要添加到字符串的属性。
beginIndex
- 该范围的第一个字符的索引。
endIndex
- 范围最后一个字符之后紧邻字符的索引。
NullPointerException
- 如果
attribute
为 null。
IllegalArgumentException
- 如果 beginIndex 小于 0,endIndex 大于字符串的长度,或者 beginIndex 和 endIndex 一起未定义字符串的非空子范围,且属性参数不是一个空 Map。
public AttributedCharacterIterator getIterator()
public AttributedCharacterIterator getIterator(AttributedCharacterIterator.Attribute[] attributes)
attributes
- 客户端感兴趣的属性列表
public AttributedCharacterIterator getIterator(AttributedCharacterIterator.Attribute[] attributes, int beginIndex, int endIndex)
attributes
- 客户端感兴趣的属性列表
beginIndex
- 第一个字符的索引
endIndex
- 最后一个字符之后紧邻字符的索引
IllegalArgumentException
- 如果 beginIndex 小于 0,endIndex 大于字符串的长度,或者 beginIndex 大于 endIndex。
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。