Класс 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` из исходного текста.

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

Модификатор и тип	Метод	Описание
`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

Возвращает:

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

См. также:

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.

© 1993, 2021, 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/17/docs/api/java.desktop/java/awt/font/TextMeasurer.html