java.awt.font
クラス TextMeasurer

java.lang.Object
  |
  +--java.awt.font.TextMeasurer

public final class TextMeasurer

extends Object

TextMeasurer は、有効幅の測定、文字範囲の有効幅の指定、文字範囲の TextLayout の作成など、改行に必要な基本操作を提供します。パラグラフが増えた場合の編集メソッドも提供します。

ほとんどのクライアントは、標準改行 (各行に配置できるだけの文字を配置) を実装する便利な LineBreakMeasurer を使用します。

導入されたバージョン:

1.3

関連項目:

LineBreakMeasurer

コンストラクタの概要

TextMeasurer(AttributedCharacterIterator text, FontRenderContext frc)
ソーステキストから TextMeasurer を構築します。

メソッドの概要

void	deleteChar(AttributedCharacterIterator newParagraph, int deletePos) この TextMeasurer が現在表すパラグラフで 1 文字を削除してから TextMeasurer を更新します。
float	getAdvanceBetween(int start, int limit) start で始まり、limit までの文字を含む行のグラフィック幅を返します。
TextLayout	getLayout(int start, int limit) 指定された文字範囲の TextLayout を返します。
int	getLineBreakIndex(int start, float maxAdvance) start で始まり、グラフィック幅が maxAdvance の行に配置できない最初の文字のインデックスを返します。
void	insertChar(AttributedCharacterIterator newParagraph, int insertPos) この TextMeasurer が現在表すパラグラフへ 1 文字を挿入してから TextMeasurer を更新します。

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

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

コンストラクタの詳細

TextMeasurer

public TextMeasurer(AttributedCharacterIterator text,
                    FontRenderContext frc)

ソーステキストから TextMeasurer を構築します。ソーステキストは 1 段落全体になります。

パラメータ:

text - ソース段落。null は不可

frc - テキストを正確に測定する場合に必要なグラフィックスデバイスに関する情報。null は不可

メソッドの詳細

getLineBreakIndex

public int getLineBreakIndex(int start,
                             float maxAdvance)

start で始まり、グラフィック幅が maxAdvance の行に配置できない最初の文字のインデックスを返します。

パラメータ:

start - 測定を開始する位置の文字インデックス。start は絶対インデックスで、パラグラフのスタートに関するものではない

maxAdvance - 行を配置するグラフィック幅

戻り値:

start で始まり、グラフィック幅が maxAdvance 以内の行に配置できる最後の文字の後のインデックス

getAdvanceBetween

public float getAdvanceBetween(int start,
                               int limit)

start で始まり、limit までの文字を含む行のグラフィック幅を返します。start と limit は絶対インデックスで、パラグラフのスタートには関連しません。

パラメータ:

start - 測定を開始する場所の文字インデックス

limit - 測定を終了する場所の文字インデックス

戻り値:

start から始まり、limit までの文字を含む行のグラフィック幅

getLayout

public TextLayout getLayout(int start,
                            int limit)

指定された文字範囲の TextLayout を返します。

パラメータ:

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

limit - テキスト内の最後の文字の次のインデックス。start より大きくなければならない

戻り値:

start から始まり、limit より小さい文字の TextLayout

insertChar

public void insertChar(AttributedCharacterIterator newParagraph,
                       int insertPos)

この TextMeasurer が現在表すパラグラフへ 1 文字を挿入してから TextMeasurer を更新します。この呼び出しの後、TextMeasurer は、テキストから作成された新しい TextMeasurer と同等になります。しかし、通常は、まったくゼロから新しいものを作成するより既存の TextMeasurer を更新した方が効率的です。

パラメータ:

newParagraph - 挿入をした後のパラグラフのテキスト。null は不可

insertPos - 文字を挿入したテキストの位置。newParagraph の開始位置よりあとで、newParagraph の終了位置より前

deleteChar

public void deleteChar(AttributedCharacterIterator newParagraph,
                       int deletePos)

この TextMeasurer が現在表すパラグラフで 1 文字を削除してから TextMeasurer を更新します。この呼び出しの後、TextMeasurer は、テキストから作成された新しい TextMeasurer と同等になります。しかし、通常は、まったくゼロから新しいものを作成するより既存の TextMeasurer を更新した方が効率的です。

パラメータ:

newParagraph - 削除をした後のパラグラフのテキスト。null は不可

deletePos - 文字を削除したテキストの位置。newParagraph の開始位置よりあとで、newParagraph の終了位置より前