AllowUserTextSelection - TPdfView

Эта запись API сохраняет идентификаторы, сигнатуры, блоки кода и термины PDF в исходном виде.

Компонент: TPdfView · Модуль: PDFium

Управляет выбором текста в просмотрщике, инициируемым вводом пользователя

Синтаксис

property AllowUserTextSelection: Boolean;

Описание

Когда True (по умолчанию), просмотрщик реагирует на пользовательский ввод, связанный с выделением:

Левый щелчок по символу текста запускает выделение перетаскиванием; щелчок по пустому месту переходит к уже существующему пути панорамирования
Двойной щелчок выделяет слово под курсором; тройной щелчок выделяет строку
Наведение на символ переключает Cursor в crIBeam
Ctrl+A выбирает текущую страницу (обе страницы в режимах разворота)
Ctrl+C копирует выделение в буфер обмена Windows как CF_UNICODETEXT
Shift+Left / Right расширяет выделение на один символ; Shift+Home / End расширяет его до видимого края строки
Перетаскивание указателя в мертвую зону у края просмотрщика шириной 20 пикселей автоматически прокручивает страницу, пока перетаскивание активно

Когда False, все перечисленное выше молча отключается, и просмотрщик ведет себя как v1.16.x — только панорамирование, только щелчки по ссылкам, только заполнение форм Киоск-хосты, области предварительного просмотра и контексты только для чтения могут закрепить этот флаг в False на этапе проектирования

Этот флаг только блокирует пользовательский ввод Публичный API на уровне кода (SelectAll, ClearSelection, CopySelectionToClipboard) продолжает работать независимо от значения флага, поэтому приложение-хост может отключить выделение, инициируемое пользователем, и при этом по-прежнему строить кнопки панели инструментов "Select All / Copy", которые вызывают тот же API

Примечания

Зарезервировано в v1.17.0 (свойство опубликовано, логика не подключена). Активно с v1.36.0 — существующие приложения обновляются без изменения поведения, потому что значением по умолчанию по-прежнему является True, а подсистема заполнения форм сохраняет приоритет
While a form field is being edited, all selection keyboard shortcuts defer so the field receives Ctrl+C / Ctrl+A / Shift+arrows for its own selection.
Set design-time defaults in the Object Inspector or assign at runtime before Active := True; selection clears on SetPdf, SetPageNumber, SetActive(False), and DisplayMode changes.

Пример

begin
  PdfView1.AllowUserTextSelection := True;
  PdfView1.SelectionColor := clHighlight;
  PdfView1.OnSelectionChange := DoSelectionChange;
  PdfView1.Active := True;
end;

См. также

SelectionColor, OnSelectionChange, HasSelection, SelectAll, ClearSelection, SelectedText, CopySelectionToClipboard