java.awt.font

Класс TextMeasurer

java.lang. Объект

java.awt.font. TextMeasurer

Все Реализованные Интерфейсы:

Cloneable

public final class TextMeasurer
extends Object
implements Cloneable

TextMeasurer class обеспечивает примитивные операции, необходимые для разрыва строки: ответ к данному усовершенствованию, определяя усовершенствование диапазона символов, и генерируя a TextLayout для диапазона символов. Это также обеспечивает методы для инкрементного редактирования абзацев.

A TextMeasurer объект создается с AttributedCharacterIterator представление единственного абзаца текста. Значение, возвращенное getBeginIndex метод AttributedCharacterIterator определяет абсолют, индексируют первого символа. Значение, возвращенное getEndIndex метод AttributedCharacterIterator определяет индексировать прошлое последний знак. Эти значения определяют диапазон, индексирует, чтобы использовать в звонках TextMeasurer. Например, вызовы, чтобы получить усовершенствование диапазона текста или разрыва строки диапазона текста должны использовать, индексирует между началом, и конец индексируют значения. Звонки insertChar и deleteChar сбросьте TextMeasurer чтобы использовать начало индексируют, и конец индексируют AttributedCharacterIterator переданный в тех вызовах.

Большинство клиентов будет использовать более удобное LineBreakMeasurer, который реализует стандартную политику разрыва строки (помещающий так много слов, как будет соответствовать на каждой строке).

С тех пор:

1.3

См. Также:

LineBreakMeasurer

Сводка конструктора

Конструкторы

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

Сводка метода

Модификатор и Тип	Метод и Описание
protected Object	clone() Создает и возвращает копию этого объекта.
void	deleteChar(AttributedCharacterIterator newParagraph, int deletePos) Обновления TextMeasurer после того, как единственный символ был удален из абзаца, в настоящий момент представленного этим TextMeasurer.
float	getAdvanceBetween(int start, int limit) Возвращает графический width строки, начинающейся в start и включая символы до limit.
TextLayout	getLayout(int start, int limit) Возвраты a TextLayout на данном диапазоне символов.
int	getLineBreakIndex(int start, float maxAdvance) Возвращает индексирование первого символа, который не будет соответствовать на на строке, начинающейся в start и возможный ответ к maxAdvance в графическом width.
void	insertChar(AttributedCharacterIterator newParagraph, int insertPos) Обновления TextMeasurer после того, как единственный символ был вставлен в абзац, в настоящий момент представленный этим TextMeasurer.

Методы, наследованные от class java.lang. Объект

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

Деталь конструктора

TextMeasurer

public TextMeasurer(AttributedCharacterIterator text,
                    FontRenderContext frc)

Конструкции a TextMeasurer из исходного текста. Исходный текст должен быть единственным всем абзацем.

Параметры:

text - исходный абзац. Не может быть нуль.

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

Деталь метода

клон

protected Object clone()

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

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

 x.clone() != x

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

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

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

 x.clone().equals(x)

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

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

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

Метод clone для class Object выполняет определенную работу клонирования. Во-первых, если class этого объекта не реализует интерфейс Cloneable, тогда a CloneNotSupportedException бросается. Отметьте, что все массивы, как полагают, реализуют интерфейс Cloneable и что тип возврата clone метод типа массива T[] T[] где T является любым ссылочным типом или типом примитива. Иначе, этот метод создает новый экземпляр class этого объекта и инициализирует все его поля с точно содержанием соответствующих полей этого объекта, как будто присвоением; содержание полей самостоятельно не клонируется. Таким образом этот метод выполняет "мелкую копию" этого объекта, не "глубокой копии" работа.

class Object самостоятельно не реализует интерфейс Cloneable, так вызов clone метод на объекте, class которого Object приведет к выдаче исключения во время выполнения.

Переопределения:

clone в class Object

Возвраты:

клон этого экземпляра.

См. Также:

Cloneable

getLineBreakIndex

public int getLineBreakIndex(int start,
                             float maxAdvance)

Возвращает индексирование первого символа, который не будет соответствовать на на строке, начинающейся в start и возможный ответ к maxAdvance в графическом width.

Параметры:

start - символ индексирует, в котором можно начать измеряться. start абсолют, индексируют, не относительно запуска абзаца

maxAdvance - графический width, в котором должна соответствовать строка

Возвраты:

индексирование после последнего знака, который будет соответствовать на строке, начинающейся в start, который не более длинен чем maxAdvance в графическом width

Броски:

IllegalArgumentException - если start меньше чем начало абзаца.

getAdvanceBetween

public float getAdvanceBetween(int start,
                               int limit)

Возвращает графический width строки, начинающейся в start и включая символы до limit. start и limit абсолютные индексы, не относительно запуска абзаца.

Параметры:

start - символ индексирует, в котором можно начать измеряться

limit - символ индексирует, в котором можно прекратить измеряться

Возвраты:

графический width строки, начинающейся в start и включая символы до limit

Броски:

IndexOutOfBoundsException - если limit меньше чем start

IllegalArgumentException - если start или limit не между началом абзаца и концом абзаца.

getLayout

public TextLayout getLayout(int start,
                            int limit)

Возвраты a TextLayout на данном диапазоне символов.

Параметры:

start - индексирование первого символа

limit - индексирование после последнего знака. Должно быть больше чем start

Возвраты:

a TextLayout для символов, начинающихся в start до (но не включая) limit

Броски:

IndexOutOfBoundsException - если limit меньше чем start

IllegalArgumentException - если start или limit не между началом абзаца и концом абзаца.

insertChar

public void insertChar(AttributedCharacterIterator newParagraph,
                       int insertPos)

Обновления TextMeasurer после того, как единственный символ был вставлен в абзац, в настоящий момент представленный этим TextMeasurer. После этого вызова, этого TextMeasurer эквивалентно новому TextMeasurer создаваемый из текста; однако, обычно будет более эффективно обновить существующее TextMeasurer чем создать новый с нуля.

Параметры:

newParagraph - текст абзаца после выполнения вставки. Не может быть нуль.

insertPos - позиция в тексте, где символ был вставлен. Не должны быть меньше чем запуск newParagraph, и должны быть меньше чем конец newParagraph.

Броски:

IndexOutOfBoundsException - если insertPos меньше чем запуск newParagraph или больше чем или равный до конца newParagraph

NullPointerException - если newParagraph null

deleteChar

public void deleteChar(AttributedCharacterIterator newParagraph,
                       int deletePos)

Обновления TextMeasurer после того, как единственный символ был удален из абзаца, в настоящий момент представленного этим TextMeasurer. После этого вызова, этого TextMeasurer эквивалентно новому TextMeasurer создаваемый из текста; однако, обычно будет более эффективно обновить существующее TextMeasurer чем создать новый с нуля.

Параметры:

newParagraph - текст абзаца после выполнения удаления. Не может быть нуль.

deletePos - позиция в тексте, куда символ был удален. Не должны быть меньше чем запуск newParagraph, и не должно быть больше чем конец newParagraph.

Броски:

IndexOutOfBoundsException - если deletePos меньше чем запуск newParagraph или больше чем конец newParagraph

NullPointerException - если newParagraph null