-
- All Superinterfaces:
-
CharacterIterator
,Cloneable
public interface AttributedCharacterIterator extends CharacterIterator
一个AttributedCharacterIterator
允许通过文本和相关的属性信息进行迭代。属性是由键标识的键/值对。 给定字符上没有两个属性可以具有相同的键。
属性的值是不可变的,不能被客户机或存储设备突变。 它们总是通过引用传递,而不是被克隆。
关于属性的运行是一个最大文本范围:
- 该属性未定义,或
null
为整个范围,或 - 属性值被定义,并且对于整个范围具有相同的非
null
值。
相对于一组属性的运行是每个成员属性满足此条件的最大文本范围。
当获得没有指定明确属性的运行(即调用
getRunStart()
和getRunLimit()
)时,具有相同属性(相同属性/值对集合)的任何连续文本段被视为单独的运行,如果属性已被赋予这些文本段分开。返回的索引仅限于迭代器的范围。
返回的属性信息仅限于包含当前字符的运行。
属性键是
AttributedCharacterIterator.Attribute
及其子类的实例,例如TextAttribute
。- 从以下版本开始:
- 1.2
- 另请参见:
-
AttributedCharacterIterator.Attribute
,TextAttribute
,AttributedString
,Annotation
-
-
Nested Class Summary
Nested Classes Modifier and Type 接口 描述 static class
AttributedCharacterIterator.Attribute
定义用于标识文本属性的属性键。
-
Field Summary
-
Fields inherited from interface java.text.CharacterIterator
DONE
-
-
方法摘要
所有方法 接口方法 抽象方法 Modifier and Type 方法 描述 Set<AttributedCharacterIterator.Attribute>
getAllAttributeKeys()
返回在迭代器的文本范围上定义的所有属性的关键字。Object
getAttribute(AttributedCharacterIterator.Attribute attribute)
返回当前字符的名称为attribute
的值。Map<AttributedCharacterIterator.Attribute,Object>
getAttributes()
返回当前字符中定义的属性的地图。int
getRunLimit()
相对于包含当前字符的所有属性返回运行后第一个字符的索引。int
getRunLimit(AttributedCharacterIterator.Attribute attribute)
返回运行后相对于包含当前字符的给定attribute
的第一个字符的索引。int
getRunLimit(Set<? extends AttributedCharacterIterator.Attribute> attributes)
相对于包含当前字符的给定的attributes
返回运行后的第一个字符的索引。int
getRunStart()
相对于包含当前字符的所有属性返回运行的第一个字符的索引。int
getRunStart(AttributedCharacterIterator.Attribute attribute)
返回相对于包含当前字符的给定的attribute
的运行的第一个字符的索引。int
getRunStart(Set<? extends AttributedCharacterIterator.Attribute> attributes)
相对于包含当前字符的给定的attributes
返回运行的第一个字符的索引。-
Methods inherited from interface java.text.CharacterIterator
clone, current, first, getBeginIndex, getEndIndex, getIndex, last, next, previous, setIndex
-
-
-
-
方法详细信息
-
getRunStart
int getRunStart()
相对于包含当前字符的所有属性返回运行的第一个字符的索引。如果已将属性分别提供给这些文本段,则具有相同属性(相同的属性/值对集合)的任何连续文本段被视为单独的运行。
- 结果
- 运行的第一个字符的索引
-
getRunStart
int getRunStart(AttributedCharacterIterator.Attribute attribute)
相对于包含当前字符的给定attribute
返回运行的第一个字符的索引。- 参数
-
attribute
- 所需属性。 - 结果
- 运行的第一个字符的索引
-
getRunStart
int getRunStart(Set<? extends AttributedCharacterIterator.Attribute> attributes)
相对于包含当前字符的给定的attributes
返回运行的第一个字符的索引。- 参数
-
attributes
- 一组所需属性。 - 结果
- 运行的第一个字符的索引
-
getRunLimit
int getRunLimit()
相对于包含当前字符的所有属性返回运行后第一个字符的索引。如果已将属性分别提供给这些文本段,则具有相同属性(相同的属性/值对集合)的任何连续文本段被视为单独的运行。
- 结果
- 运行后的第一个字符的索引
-
getRunLimit
int getRunLimit(AttributedCharacterIterator.Attribute attribute)
相对于包含当前字符的给定的attribute
返回运行后的第一个字符的索引。- 参数
-
attribute
- 所需属性 - 结果
- 运行后的第一个字符的索引
-
getRunLimit
int getRunLimit(Set<? extends AttributedCharacterIterator.Attribute> attributes)
返回运行后相对于包含当前字符的给定attributes
的第一个字符的索引。- 参数
-
attributes
- 一组所需属性 - 结果
- 运行后的第一个字符的索引
-
getAttributes
Map<AttributedCharacterIterator.Attribute,Object> getAttributes()
返回当前字符中定义的属性的地图。- 结果
- 具有当前字符定义的属性的地图
-
getAttribute
Object getAttribute(AttributedCharacterIterator.Attribute attribute)
返回当前字符的名称为attribute
的值。 如果attribute
则返回null
。- 参数
-
attribute
- 所需属性 - 结果
-
名称为
attribute
或null
的值
-
getAllAttributeKeys
Set<AttributedCharacterIterator.Attribute> getAllAttributeKeys()
返回在迭代器的文本范围上定义的所有属性的关键字。 如果没有定义属性,则该集合为空。- 结果
- the keys of all attributes
-
-