compact1, compact2, compact3

java.text

クラスAttributedString

java.lang.Object

java.text.AttributedString

public class AttributedString
extends Object

テキストとそのテキストに関連する属性情報を保持します。テキストを読み取るユーザーが、AttributedCharacterIteratorインタフェース経由で属性付きテキストにアクセスする必要がある場合、このクラスを実際のデータ・ストレージとして使用できます。

属性はキーと値のペアであり、キーで識別されます。1つの文字に対して複数の属性キーを定義することはできません。

属性の値は不変です。つまり、クライアントやストレージによって変更できません。属性の値は常に参照渡しです。複製されることはありません。

導入されたバージョン:

1.2

関連項目:

AttributedCharacterIterator, Annotation

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
AttributedString(AttributedCharacterIterator text) 指定されたAttributedCharacterIteratorが表現する属性付きテキストを持つ、AttributedStringインスタンスを構築します。
AttributedString(AttributedCharacterIterator text, int beginIndex, int endIndex) 指定されたAttributedCharacterIteratorが表現する属性付きテキストの部分範囲を持つAttributedStringインスタンスを構築します。
AttributedString(AttributedCharacterIterator text, int beginIndex, int endIndex, AttributedCharacterIterator.Attribute[] attributes) 指定されたAttributedCharacterIteratorが表現する属性付きテキストの部分範囲を持つAttributedStringインスタンスを構築します。
AttributedString(String text) 指定されたテキストを持つAttributedStringインスタンスを構築します。
AttributedString(String text, Map<? extends AttributedCharacterIterator.Attribute,?> attributes) 指定されたテキストと属性を持つAttributedStringインスタンスを構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
void	addAttribute(AttributedCharacterIterator.Attribute attribute, Object value) 属性を文字列全体に追加します。
void	addAttribute(AttributedCharacterIterator.Attribute attribute, Object value, int beginIndex, int endIndex) 属性を文字列の部分範囲に追加します。
void	addAttributes(Map<? extends AttributedCharacterIterator.Attribute,?> attributes, int beginIndex, int endIndex) 一連の属性を文字列の部分範囲に追加します。
AttributedCharacterIterator	getIterator() この文字列の内容全体にアクセスできるAttributedCharacterIteratorインスタンスを作成します。
AttributedCharacterIterator	getIterator(AttributedCharacterIterator.Attribute[] attributes) この文字列の選択された内容にアクセスできるAttributedCharacterIteratorインスタンスを作成します。
AttributedCharacterIterator	getIterator(AttributedCharacterIterator.Attribute[] attributes, int beginIndex, int endIndex) この文字列の選択された内容にアクセスできるAttributedCharacterIteratorインスタンスを作成します。

クラス java.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

AttributedString

public AttributedString(String text)

指定されたテキストを持つAttributedStringインスタンスを構築します。

パラメータ:

text - この属性付き文字列のテキスト。

例外:

NullPointerException - textがnullである場合。

AttributedString

public AttributedString(String text,
                        Map<? extends AttributedCharacterIterator.Attribute,?> attributes)

指定されたテキストと属性を持つAttributedStringインスタンスを構築します。

パラメータ:

text - この属性付き文字列のテキスト。

attributes - 文字列全体に適用する属性。

例外:

NullPointerException - textまたはattributesがnullの場合。

IllegalArgumentException - テキスト長が0で、かつ属性パラメータが空のMapでない場合(長さ0の範囲には属性を適用できない)。

AttributedString

public AttributedString(AttributedCharacterIterator text)

指定されたAttributedCharacterIteratorが表現する属性付きテキストを持つ、AttributedStringインスタンスを構築します。

パラメータ:

text - この属性付き文字列のテキスト。

例外:

NullPointerException - textがnullである場合。

AttributedString

public AttributedString(AttributedCharacterIterator text,
                        int beginIndex,
                        int endIndex)

指定されたAttributedCharacterIteratorが表現する属性付きテキストの部分範囲を持つAttributedStringインスタンスを構築します。指定された範囲が空のテキストを生成する場合、すべての属性が破棄されます。元の属性範囲の部分範囲に対しては、Annotationオブジェクトによってラップされた属性はすべて破棄されます。

パラメータ:

text - この属性付き文字列のテキスト。

beginIndex - 範囲の先頭文字のインデックス。

endIndex - 範囲の末尾文字の次の文字のインデックス。

例外:

NullPointerException - textがnullである場合。

IllegalArgumentException - beginIndexとendIndexで指定された部分範囲がテキストの範囲外にある場合。

関連項目:

Annotation

AttributedString

public AttributedString(AttributedCharacterIterator text,
                        int beginIndex,
                        int endIndex,
                        AttributedCharacterIterator.Attribute[] attributes)

指定されたAttributedCharacterIteratorが表現する属性付きテキストの部分範囲を持つAttributedStringインスタンスを構築します。指定された属性に一致する属性だけがインスタンスに組み込まれます。指定された範囲が空のテキストを生成する場合、すべての属性が破棄されます。元の属性範囲の部分範囲に対しては、Annotationオブジェクトによってラップされた属性はすべて破棄されます。

パラメータ:

text - この属性付き文字列のテキスト。

beginIndex - 範囲の先頭文字のインデックス。

endIndex - 範囲の末尾文字の次の文字のインデックス。

attributes - テキストから抽出する属性を指定する。nullが指定された場合、利用可能なすべての属性が使用される。

例外:

NullPointerException - textがnullである場合。

IllegalArgumentException - beginIndexとendIndexで指定された部分範囲がテキストの範囲外にある場合。

関連項目:

Annotation

メソッドの詳細

addAttribute

public void addAttribute(AttributedCharacterIterator.Attribute attribute,
                         Object value)

属性を文字列全体に追加します。

パラメータ:

attribute - 属性キー

value - 属性の値。nullも指定可能

例外:

NullPointerException - attributeがnullである場合。

IllegalArgumentException - AttributedStringの長さが0の場合(長さ0の範囲には属性を適用できない)。

addAttribute

public void addAttribute(AttributedCharacterIterator.Attribute attribute,
                         Object value,
                         int beginIndex,
                         int endIndex)

属性を文字列の部分範囲に追加します。

パラメータ:

attribute - 属性キー

value - 属性の値。nullも可。

beginIndex - 範囲の先頭文字のインデックス。

endIndex - 範囲の末尾文字の次の文字のインデックス。

例外:

NullPointerException - attributeがnullである場合。

IllegalArgumentException - eginIndexが0より小さい場合、endIndexが文字列長より大きい場合、あるいはbeginIndexとendIndexで定義される文字列の部分範囲が空になる場合。

addAttributes

public void addAttributes(Map<? extends AttributedCharacterIterator.Attribute,?> attributes,
                          int beginIndex,
                          int endIndex)

一連の属性を文字列の部分範囲に追加します。

パラメータ:

attributes - 文字列に追加する属性。

beginIndex - 範囲の先頭文字のインデックス。

endIndex - 範囲の末尾文字の次の文字のインデックス。

例外:

NullPointerException - attributesがnullである場合。

IllegalArgumentException - beginIndexが0より小さい場合、endIndexが文字列長より大きい場合、あるいはbeginIndexとendIndexで定義される文字列の部分範囲が空になり、かつ属性パラメータが空のMapでない場合。

getIterator

public AttributedCharacterIterator getIterator()

この文字列の内容全体にアクセスできるAttributedCharacterIteratorインスタンスを作成します。

戻り値:

テキストとその属性にアクセスできるイテレータ。

getIterator

public AttributedCharacterIterator getIterator(AttributedCharacterIterator.Attribute[] attributes)

この文字列の選択された内容にアクセスできるAttributedCharacterIteratorインスタンスを作成します。attributesに含まれていない属性の情報を実装者が保持する場合、それらの情報をこのイテレータ経由でアクセス可能にする必要はありません。リストがnullの場合、利用可能なすべての属性の情報にアクセスできる必要があります。

パラメータ:

attributes - クライアントが興味を持っている属性のリスト

戻り値:

テキスト全体とその選択された属性にアクセスできるイテレータ

getIterator

public AttributedCharacterIterator getIterator(AttributedCharacterIterator.Attribute[] attributes,
                                               int beginIndex,
                                               int endIndex)

この文字列の選択された内容にアクセスできるAttributedCharacterIteratorインスタンスを作成します。attributesに含まれていない属性の情報を実装者が保持する場合、それらの情報をこのイテレータ経由でアクセス可能にする必要はありません。リストがnullの場合、利用可能なすべての属性の情報にアクセスできる必要があります。

パラメータ:

attributes - クライアントが興味を持っている属性のリスト

beginIndex - 最初の文字のインデックス

endIndex - 最後の文字のあとに続く文字のインデックス

戻り値:

テキストおよびテキストの属性にアクセスできるイテレータ

例外:

IllegalArgumentException - beginIndexが0より小さい場合、endIndexが文字列長より大きい場合、あるいはbeginIndexがendIndexより大きい場合。