Класс TextMeasurer

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

Все реализованные интерфейсы:: Cloneable

public final class TextMeasurer
extends Object
implements Cloneable

Класс TextMeasurer предоставляет базовые операции, необходимые для переноса строк: измерение до заданного смещения, определение смещения диапазона символов и генерацию TextLayout для диапазона символов. Он также предоставляет методы для инкрементного редактирования абзацев.

Объект TextMeasurer создаётся с помощью AttributedCharacterIterator, представляющего собой единственный абзац текста. Значение, возвращаемое методом getBeginIndex объекта AttributedCharacterIterator, определяет абсолютный индекс первого символа. Значение, возвращаемое методом getEndIndex объекта AttributedCharacterIterator, определяет индекс после последнего символа. Эти значения определяют диапазон индексов, используемых в вызовах TextMeasurer. Например, вызовы для получения смещения диапазона текста или переноса строки диапазона текста должны использовать индексы между начальным и конечным индексами. Вызовы insertChar и deleteChar сбрасывают TextMeasurer для использования начального и конечного индексов AttributedCharacterIterator , переданных в этих вызовах.

Большинство клиентов будут использовать более удобный LineBreakMeasurer, который реализует стандартную политику переноса строк (размещая как можно больше слов на каждой строке).

С момента:: 1.3
См. также:: LineBreakMeasurer

Конструкторы

Конструктор	Описание
`TextMeasurer(AttributedCharacterIterator text, FontRenderContext frc)`	Создаёт `TextMeasurer` из исходного текста.

Методы

Модификатор и тип	Метод	Описание
`void`	`deleteChar(AttributedCharacterIterator newParagraph, int deletePos)`	Обновляет `TextMeasurer` после удаления одного символа из абзаца, который в данный момент представлен этим `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` после вставки одного символа в абзац, который в данный момент представлен этим `TextMeasurer`.

Методы, объявленные в классе java.lang.Object

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

Конструкторы

TextMeasurer

public TextMeasurer(AttributedCharacterIterator text,
                    FontRenderContext frc)

Создаёт TextMeasurer из исходного текста. Исходный текст должен представлять собой один полный абзац.

Параметры:: text - исходный абзац. Не может быть null.; frc - информация об устройстве графики, которая необходима для правильного измерения текста. Не может быть null.

Методы

getLineBreakIndex

public int getLineBreakIndex(int start,
                             float maxAdvance)

Возвращает индекс первого символа, который не поместится в строку, начинающуюся с start и, возможно, измеряемой до maxAdvance в графической ширине.

Параметры:: start - индекс символа, с которого нужно начать измерение. start - это абсолютный индекс, а не относительный к началу абзаца; maxAdvance - графическая ширина, в которой строка должна уместиться
Возвращает:: индекс после последнего символа, который поместится в строку, начинающуюся с start, которая не длиннее maxAdvance в графической ширине
Исключения:: IllegalArgumentException - если start меньше начала абзаца.

getAdvanceBetween

public float getAdvanceBetween(int start,
                               int limit)

Возвращает графическую ширину строки, начинающейся с start и включающей символы до limit. start и limit - абсолютные индексы, а не относительные к началу абзаца.

Параметры:: start - индекс символа, с которого нужно начать измерение; limit - индекс символа, по которому нужно прекратить измерение
Возвращает:: графическая ширина строки, начинающейся с start и включающей символы до limit
Исключения:: IndexOutOfBoundsException - если limit меньше start; IllegalArgumentException - если start или limit не находятся между началом и концом абзаца.

getLayout

public TextLayout getLayout(int start,
                            int limit)

Возвращает TextLayout для заданного диапазона символов.

Параметры:: start - индекс первого символа; limit - индекс после последнего символа. Должен быть больше start
Возвращает:: TextLayout для символов, начинающихся с start до (но не включая) limit
Исключения:: IndexOutOfBoundsException - если limit меньше start; IllegalArgumentException - если start или limit не находятся между началом и концом абзаца.

insertChar

public void insertChar(AttributedCharacterIterator newParagraph,
                       int insertPos)

Обновляет TextMeasurer после вставки одного символа в абзац, который в данный момент представлен этим TextMeasurer. После этого вызова этот TextMeasurer эквивалентен новому TextMeasurer , созданному из текста; однако, обычно более эффективно обновить существующий TextMeasurer , чем создавать новый с нуля.

Параметры:: newParagraph - текст абзаца после выполнения вставки. Не может быть null.; insertPos - позиция в тексте, где был вставлен символ. Должен быть не меньше начала newParagraph, и должен быть меньше конца newParagraph.
Исключения:: IndexOutOfBoundsException - если insertPos меньше начала newParagraph или больше или равно концу newParagraph; NullPointerException - если newParagraph - null

deleteChar

public void deleteChar(AttributedCharacterIterator newParagraph,
                       int deletePos)

Обновляет TextMeasurer после удаления одного символа из абзаца, который в данный момент представлен этим TextMeasurer. После этого вызова этот TextMeasurer эквивалентен новому TextMeasurer , созданному из текста; однако, обычно более эффективно обновить существующий TextMeasurer , чем создавать новый с нуля.

Параметры:: newParagraph - текст абзаца после выполнения удаления. Не может быть null.; deletePos - позиция в тексте, где был удалён символ. Должен быть не меньше начала newParagraph, и не должен быть больше конца newParagraph.
Исключения:: IndexOutOfBoundsException - если deletePos меньше начала newParagraph или больше конца newParagraph; NullPointerException - если newParagraph - null