模块  java.base
软件包  java.text

Interface AttributedCharacterIterator

  • All Superinterfaces:
    CharacterIterator ， Cloneable 
    public interface AttributedCharacterIterator
extends CharacterIterator
    AttributedCharacterIterator允许迭代文本和相关属性信息。

    属性是由键标识的键/值对。 给定字符上没有两个属性可以具有相同的键。

    属性的值是不可变的，或者客户端或存储不得突变。 它们总是通过引用传递，而不是克隆。

    相对于属性的运行是最大文本范围，其中：

    • 该属性未定义或整个范围为null ，或
    • 属性值已定义，并且整个范围具有相同的非null值。

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

    当获得没有指定显式属性的运行时（即，调用getRunStart()和getRunLimit() ），具有相同属性（相同的属性/值对集合）的任何连续文本段将被视为单独运行（如果已将属性赋予这些文本）细分市场。

    返回的索引仅限于迭代器的范围。

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

    属性键是AttributedCharacterIterator.Attribute及其子类的实例，例如TextAttribute 。

    从以下版本开始：
    1.2
    另请参见：
    AttributedCharacterIterator.Attribute ， TextAttribute ， AttributedString ， Annotation

    • 方法详细信息

      • 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 - 一组所需的属性
        结果
        运行后的第一个字符的索引

      • getAttribute

        Object getAttribute​(AttributedCharacterIterator.Attribute attribute)
        返回当前字符的指定值attribute 。 如果attribute则返回null 。
        参数
        attribute - 所需的属性
        结果
        名称为 attribute或 null的值

      • getAllAttributeKeys

        Set<AttributedCharacterIterator.Attribute> getAllAttributeKeys()
        返回迭代器文本范围中定义的所有属性的键。 如果未定义任何属性，则该集为空。
        结果
        the keys of all attributes