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