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

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечёт заданное время.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечёт заданное время.

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

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.