- すべてのスーパー・インタフェース:
CharacterIterator
,Cloneable
public interface AttributedCharacterIterator extends CharacterIterator
AttributedCharacterIterator
は、テキストとそのテキストに関連する属性情報を、どちらも反復処理できるようにします。
属性はキーと値のペアであり、キーで識別されます。 1つの文字に対して複数の属性キーを定義することはできません。
属性の値は不変です。つまり、クライアントやストレージによって変更できません。 属性の値は常に参照渡しです。複製されることはありません。
次の場合、属性についてのランは、最大テキスト範囲です。
- 属性が範囲全体に対して未定義または
null
である、あるいは - 属性値が定義され、範囲全体に対して
null
以外の同じ値を持つ。
属性セットについてのランは、それぞれのメンバー属性について上記の条件が成立する最大テキスト範囲です。
明示的な属性を指定せずにランを取得すると(すなわち、getRunStart()
およびgetRunLimit()
を呼び出すと)、同じ属性(同じ属性/値ペア・セット)を持つ連続したテキスト・セグメントは、属性がそれらのテキスト・セグメントに個別に与えられている場合、別個のランとして扱われます。
返されるインデックスは、イテレータの範囲に限定されます。
返される属性情報は、現在の文字を保持するランに限定されます。
属性キーは、AttributedCharacterIterator.Attribute
およびそのサブクラス(TextAttribute
など)のインスタンスです。
- 導入されたバージョン:
- 1.2
- 関連項目:
AttributedCharacterIterator.Attribute
,TextAttribute
,AttributedString
,Annotation
-
ネストされたクラスのサマリー
ネストされたクラス -
フィールドのサマリー
インタフェース java.text.CharacterIteratorで宣言されたフィールド
DONE
-
メソッドのサマリー
修飾子と型メソッド説明イテレータのテキスト範囲で定義されたすべての属性のキーを返します。getAttribute(AttributedCharacterIterator.Attribute attribute)
現在の文字について指定されたattribute
の値を返します。現在の文字に定義された属性を持つマップを返します。int
現在の文字を保持するすべての属性について、ランの次に来る先頭文字のインデックスを返します。int
getRunLimit(AttributedCharacterIterator.Attribute attribute)
現在の文字を保持する指定されたattribute
について、ランの次に来る先頭文字のインデックスを返します。int
getRunLimit(Set<? extends AttributedCharacterIterator.Attribute> attributes)
現在の文字を保持する指定されたattributes
について、ランの次に来る先頭文字のインデックスを返します。int
現在の文字を保持するすべての属性について、ランの先頭文字のインデックスを返します。int
getRunStart(AttributedCharacterIterator.Attribute attribute)
現在の文字を保持する指定されたattribute
について、ランの先頭文字のインデックスを返します。int
getRunStart(Set<? extends AttributedCharacterIterator.Attribute> attributes)
現在の文字を保持する指定されたattributes
について、ランの先頭文字のインデックスを返します。インタフェース 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()イテレータのテキスト範囲で定義されたすべての属性のキーを返します。 属性が定義されていない場合、セットは空です。- 戻り値:
- すべての属性のキー
-