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