Класс 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

См. также:

Краткое описание конструкторов

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

Краткое описание методов

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`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

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

Подробное описание конструкторов

TextMeasurer

public TextMeasurer(AttributedCharacterIterator text, FontRenderContext frc)

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

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

Подробное описание методов

clone

protected Object clone()

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

Создаёт и возвращает копию этого объекта. Точное значение "копии" может зависеть от класса объекта. Общая цель заключается в том, что для любого объекта x выражение:

 x.clone() != x

будет истинным, а выражение:

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

будет true, но это не абсолютные требования. Хотя обычно:

 x.clone().equals(x)

будет true, это не абсолютное требование.

По соглашению, возвращаемый объект должен быть получен вызовом super.clone. Если класс и все его суперклассы (кроме Object) следуют этому соглашению, то x.clone().getClass() == x.getClass().

По соглашению, объект, возвращаемый этим методом, должен быть независимым от этого объекта (который клонируется). Для достижения этой независимости может потребоваться изменить один или несколько полей объекта, возвращаемого super.clone, перед его возвращением. Обычно это означает копирование любых изменяемых объектов, составляющих внутреннюю "глубокую структуру" клонируемого объекта, и замену ссылок на эти объекты ссылками на копии. Если класс содержит только примитивные поля или ссылки на неизменяемые объекты, то обычно не нужно изменять поля объекта, возвращаемого super.clone.

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

clone в классе Object

Возвращает:

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

См. также:

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

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/font/TextMeasurer.html