JavaTM Platform
Standard Ed. 6

java.text
接口 AttributedCharacterIterator

所有超级接口:
CharacterIterator, Cloneable

public interface AttributedCharacterIterator
extends CharacterIterator

AttributedCharacterIterator 允许对文本和相关属性信息的迭代。

属性是一个由键来标识的键/值对。在一个给定字符上的两个属性不能有相同的键。

一个属性的值是不可变的,或者不能由客户端或存储来改变。其始终按引用而不是复制来传递。

对于以下情况,关于属性的运行 是一个最大的文本范围:

对于每个成员属性都满足此条件的关于属性集合的运行 是一个最大的文本范围。

返回的索引限定于迭代器的范围之内。

返回的属性信息限定于包含当前字符的运行中。

属性键是 AttributedCharacterIterator.Attribute 及其子类的实例,比如 java.awt.font.TextAttribute。

从以下版本开始:
1.2
另请参见:
AttributedCharacterIterator.Attribute。, java.awt.font.TextAttribute。, AttributedString。, Annotation。

嵌套类摘要
static class AttributedCharacterIterator.Attribute
          定义用于标识文本属性的属性键。
 
字段摘要
 
从接口 java.text.CharacterIterator 继承的字段
DONE
 
方法摘要
 Set<AttributedCharacterIterator.Attribute> getAllAttributeKeys()
          返回定义于迭代器文本范围上的所有属性的键。
 Object getAttribute(AttributedCharacterIterator.Attribute attribute)
          返回当前字符的命名属性的值。
 Map<AttributedCharacterIterator.Attribute,Object> getAttributes()
          返回具有定义于当前字符上的多个属性的映射。
 int getRunLimit()
          返回关于包含当前字符的所有属性的运行之后的第一个字符的索引。
 int getRunLimit(AttributedCharacterIterator.Attribute attribute)
          返回关于包含当前字符的给定属性的运行之后的第一个字符的索引。
 int getRunLimit(Set<? extends AttributedCharacterIterator.Attribute> attributes)
          返回关于包含当前字符的给定多个属性的运行之后的第一个字符的索引。
 int getRunStart()
          返回关于包含当前字符的所有属性的运行的第一个字符的索引。
 int getRunStart(AttributedCharacterIterator.Attribute attribute)
          返回关于包含当前字符的给定属性的运行的第一个字符的索引。
 int getRunStart(Set<? extends AttributedCharacterIterator.Attribute> attributes)
          返回关于包含当前字符的给定多个属性的运行的第一个字符的索引。
 
从接口 java.text.CharacterIterator 继承的方法
clone, current, first, getBeginIndex, getEndIndex, getIndex, last, next, previous, setIndex
 

方法详细信息

getRunStart

int getRunStart()
返回关于包含当前字符的所有属性的运行的第一个字符的索引。


getRunStart

int getRunStart(AttributedCharacterIterator.Attribute attribute)
返回关于包含当前字符的给定属性的运行的第一个字符的索引。


getRunStart

int getRunStart(Set<? extends AttributedCharacterIterator.Attribute> attributes)
返回关于包含当前字符的给定多个属性的运行的第一个字符的索引。


getRunLimit

int getRunLimit()
返回关于包含当前字符的所有属性的运行之后的第一个字符的索引。


getRunLimit

int getRunLimit(AttributedCharacterIterator.Attribute attribute)
返回关于包含当前字符的给定属性的运行之后的第一个字符的索引。


getRunLimit

int getRunLimit(Set<? extends AttributedCharacterIterator.Attribute> attributes)
返回关于包含当前字符的给定多个属性的运行之后的第一个字符的索引。


getAttributes

Map<AttributedCharacterIterator.Attribute,Object> getAttributes()
返回具有定义于当前字符上的多个属性的映射。


getAttribute

Object getAttribute(AttributedCharacterIterator.Attribute attribute)
返回当前字符的命名属性的值。Returns 如果属性未定义,则返回 null。

参数:
attribute - 其值被请求的属性的键。

getAllAttributeKeys

Set<AttributedCharacterIterator.Attribute> getAllAttributeKeys()
返回定义于迭代器文本范围上的所有属性的键。如果未定义任何属性,则集合为空。


JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策