MoveVisualCaret

Формы, взаимодействие, Unicode

Описание

Перемещает каретку активной правки на одну физическую визуальную позицию через текст слева направо, справа налево или смешанного направления

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

Расширение выделения удерживает логический якорь неподвижным и перемещает только каретку, при этом разделенные каретные позиции на двунаправленных границах сохраняют свою отдельную визуальную позицию

DispatchInputEvent делегирует клавиши Left и Right этому методу, тогда как Home, End, Up и Down сохраняют свою семантику навигации по строкам

Объявление

function MoveVisualCaret(ToRight: Boolean;
  ExtendSelection: Boolean = False): Integer;

Параметры

ToRight	`True` перемещает к физическому правому краю, а `False` — к физическому левому краю
ExtendSelection	`True` сохраняет якорь выделения и расширяет или сужает направленное выделение; `False` перемещает свёрнутый курсор или сворачивает существующее выделение

Возвращаемое значение

Возвращает 1, когда правка активна и её визуальное состояние курсора обновлено, иначе 0

Пример

Session.SetTextDirection(ftdAuto);
Session.MoveVisualCaret(False);
Session.MoveVisualCaret(True, True);

См. также

GetVisualCaretOrder, SetTextDirection, SetSelectionRange, DispatchInputEvent, TPDFlibFormSession