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

Методы, объявленные в классе 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/font/TextMeasurer.html