Класс 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, 2023, 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/21/docs/api/java.desktop/java/awt/font/TextMeasurer.html