Класс TextMeasurer

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

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

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

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

TextMeasurer

public TextMeasurer(AttributedCharacterIterator text,
                    FontRenderContext frc)

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

Параметры:

text - исходный абзац. Не может быть null.

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

Методы

clone

protected Object clone()

Описание скопировано из класса: Object

x.clone() != x

x.clone().getClass() == x.getClass()

x.clone().equals(x)

Переопределяет:

clone в классе Object

Возвращает:

клонированный экземпляр.

См. также:

Cloneable

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