java.text
介面 AttributedCharacterIterator

所有父級介面：

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()

返回定義於迭代器文本範圍上的所有屬性的鍵。如果未定義任何屬性，則集合為空。