Класс TextHitInfo

public final class TextHitInfo
extends Object

Класс TextHitInfo представляет собой позицию символа в текстовой модели и смещение, или "сторону", символа. Смещения бывают ведущими (левый край, для символов слева направо) или замыкающими (правый край, для символов слева направо). Экземпляры TextHitInfo используются для указания позиции курсора и вставки в текст.

Например, рассмотрим текст "abc". TextHitInfo.trailing(1) соответствует правой стороне символа 'b' в тексте.

TextHitInfo используется в основном классом TextLayout и клиентами TextLayout. Клиенты TextLayout запрашивают экземпляры TextHitInfo для смещения вставки, где в текстовую модель вставляется новый текст. Смещение вставки равно позиции символа в TextHitInfo, если смещение ведущее, и на один символ больше, если смещение замыкающее. Смещение вставки для TextHitInfo.trailing(1) равно 2.

Иногда удобно создать TextHitInfo с тем же смещением вставки, что и существующее, но на противоположном символе. Метод getOtherHit создаёт новый экземпляр TextHitInfo с тем же смещением вставки, что и у существующего, но на противоположной стороне символа относительно смещения вставки. Вызов getOtherHit для trailing(1) вернёт leading(2). В общем случае, вызов getOtherHit для trailing(n) вернёт leading(n+1) и getOtherHit для leading(n) вернёт trailing(n-1).

Пример:

Преобразование графической точки в точку вставки в текстовой модели

TextLayout layout = ...;
Point2D.Float hitPoint = ...;
TextHitInfo hitInfo = layout.hitTestChar(hitPoint.x, hitPoint.y);
int insPoint = hitInfo.getInsertionIndex();
// insPoint is relative to layout;  may need to adjust for use
// in a text model

Методы

getCharIndex

public int getCharIndex()

Возвращает индекс символа, на который попал указатель.

Возвращает:

индекс символа, на который попал указатель.

isLeadingEdge

public boolean isLeadingEdge()

Возвращает true, если был затронут ведущий край символа.

Возвращает:

true если был затронут ведущий край символа; false в противном случае.

getInsertionIndex

public int getInsertionIndex()

Возвращает индекс вставки. Это индекс символа, если был затронут ведущий край символа, и на единицу больше индекса символа, если был затронут замыкающий край.

Возвращает:

индекс вставки.

hashCode

public int hashCode()

Возвращает хэш-код.

Переопределяет:

hashCode в классе Object

Возвращает:

хэш-код этого TextHitInfo, который также является хэш-кодом этого TextHitInfo.

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object obj)

Возвращает true если указанный Object является экземпляром TextHitInfo и равен этому TextHitInfo.

Переопределяет:

equals в классе Object

Параметры:

obj - Object для проверки на равенство

Возвращает:

true если указанный Object равен этому TextHitInfo; false в противном случае.

См. также:

Object.hashCode(), HashMap

equals

public boolean equals(TextHitInfo hitInfo)

Возвращает true если указанный TextHitInfo имеет то же charIndex и isLeadingEdge что и этот TextHitInfo. Это не то же самое, что иметь одинаковое смещение вставки.

Параметры:

hitInfo - указанный TextHitInfo

Возвращает:

true если указанный TextHitInfo имеет то же charIndex и isLeadingEdge что и этот TextHitInfo.

toString

public String toString()

Возвращает String, представляющий собой указатель, только для отладки.

Переопределяет:

toString в классе Object

Возвращает:

String представляющий этот TextHitInfo.

leading

public static TextHitInfo leading(int charIndex)

Создаёт TextHitInfo на ведущем крае символа в указанном charIndex.

Параметры:

charIndex - индекс символа, на который попал указатель

Возвращает:

TextHitInfo на ведущем крае символа в указанном charIndex.

trailing

public static TextHitInfo trailing(int charIndex)

Создаёт указатель на замыкающий край символа в указанном charIndex.

Параметры:

charIndex - индекс символа, на который попал указатель

Возвращает:

TextHitInfo на замыкающем крае символа в указанном charIndex.

beforeOffset

public static TextHitInfo beforeOffset(int offset)

Создаёт TextHitInfo в указанном смещении, связанном с символом перед смещением.

Параметры:

offset - смещение, связанное с символом перед смещением

Возвращает:

TextHitInfo в указанном смещении.

afterOffset

public static TextHitInfo afterOffset(int offset)

Создаёт TextHitInfo в указанном смещении, связанном с символом после смещения.

Параметры:

offset - смещение, связанное с символом после смещения

Возвращает:

TextHitInfo в указанном смещении.

getOtherHit

public TextHitInfo getOtherHit()

Создаёт TextHitInfo на противоположной стороне точки вставки. Этот TextHitInfo остаётся неизменным.

Возвращает:

TextHitInfo на противоположной стороне точки вставки.

getOffsetHit

public TextHitInfo getOffsetHit(int delta)

Создаёт TextHitInfo , индекс символа которого смещён на delta от charIndex этого TextHitInfo. Этот TextHitInfo остаётся неизменным.

Параметры:

delta - значение для смещения этого charIndex

Возвращает:

TextHitInfo , индекс символа которого смещён на delta от charIndex этого TextHitInfo.