java.text

接口
异常
所有超级接口:
CharacterIterator, Cloneable

public interface AttributedCharacterIterator
     
extends CharacterIterator

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

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

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

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

  • 在整个范围中属性没有定义或为 null,或者
  • 定义了属性值并且在整个范围中具有同样的非 null 值。

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

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

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

属性键是 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()
返回定义于迭代器文本范围上的所有属性的键。如果未定义任何属性,则集合为空。