Класс DefaultCaret

public class DefaultCaret
extends Rectangle
implements Caret, FocusListener, MouseListener, MouseMotionListener

Реализация по умолчанию для Caret. Курсор отображается в виде вертикальной линии в цвете, заданном свойством CaretColor связанного JTextComponent. Он может мигать со скоростью, заданной свойством BlinkRate.

Эта реализация ожидает два источника асинхронных уведомлений. Поток таймера срабатывает асинхронно и вызывает перерисовку курсора с использованием последних границ. Курсор также отслеживает изменения при модификации документа. Обычно это происходит в потоке обработки событий в результате какого-либо события мыши или клавиатуры. Поведение курсора при обновлении как синхронных, так и асинхронных документов контролируется свойством UpdatePolicy. Перерисовка нового положения курсора будет происходить в потоке обработки событий в любом случае, так как вызовы modelToView безопасны только в потоке обработки событий.

Курсор действует как слушатель мыши и фокуса на текстовом компоненте, в котором он установлен, и определяет семантику курсора на основе этих событий. Методы слушателя можно переопределить для изменения семантики. По умолчанию для установки фокуса и положения курсора используется первая кнопка мыши. Перетаскивание указателя мыши с первой кнопкой мыши создаст выделение, непрерывное в модели. Если связанный текстовый компонент редактируется, курсор станет видимым при получении фокуса и невидимым при его потере.

Для отображения выделения по умолчанию используется Highlighter, связанный с соответствующим текстовым компонентом. Вид выделения можно настроить, предоставив painter для выделений. По умолчанию используется painter, который отобразит твёрдый цвет, указанный в связанном текстовом компоненте в свойстве SelectionColor. Это можно легко изменить, переопределив метод getSelectionPainter.

Настроить внешний вид курсора можно, переопределив метод paint. Если метод paint изменён, следует также переопределить метод damage, чтобы вызвать перерисовку необходимой области для отображения курсора. Курсор расширяет класс Rectangle, используемый для хранения прямоугольника, в котором курсор был последним отображён. Это позволяет курсору перерисовываться в потокобезопасном режиме при перемещении, без вызова modelToView, который нестабилен между обновлениями модели и ремонтом представления (т.е. порядок доставки DocumentListeners не гарантируется).

Магическое положение курсора устанавливается в null при изменении положения курсора. Таймер используется для определения нового местоположения (после изменения курсора). При срабатывании таймера, если магическое положение курсора всё ещё равно null, оно сбрасывается до текущего положения курсора. Любые действия, изменяющие положение курсора и желающие сохранить магическое положение курсора неизменным, должны запомнить магическое положение курсора, изменить курсор и затем установить магическое положение курсора в его первоначальное значение. Это выгодно тем, что только те действия, которые хотят сохранить магическое положение курсора (такие как открытие/перемещение вниз) должны знать о нём.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, использующими одну и ту же версию Swing. С версии 1.4, поддержка долгосрочного хранения всех JavaBeans™ была добавлена в пакет java.beans. См. XMLEncoder.