PDFium Delphi Component Docs

ReplaceFormTextAndKeepSelection Метод

Компонент: TPdfView  ·  Модуль: PDFium
Заменяет выделенный текст текущего поля формы в фокусе и оставляет замену выделенной

Syntax

function ReplaceFormTextAndKeepSelection(const Text: WString): Boolean;

Parameters

TextWString. Текст, записываемый поверх текущего выделения поля в фокусе; передайте пустую строку, чтобы удалить выделение

Return Value

Boolean. True, когда редактируемый текстовый виджет формы владеет фокусом на активной странице и замена была выполнена; False, когда вызов не делает ничего

Description

Заменяет текущий выделенный текст внутри того виджета формы, который владеет фокусом на активной странице просмотрщика, вызывая нативную FORM_ReplaceAndKeepSelection с форм-хендлом страницы

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

Пустая строка удаляет текущее выделение; обёртка передаёт указатель на NUL-широкий символ, чтобы PDFium никогда не получал nil-буфер

При успехе связанная сцена страницы TPdf помечается недействительной и просмотрщик перерисовывается, так что новое значение поля становится видимым немедленно

Remarks

Example

// Overtype the selected characters of the focused field,
// keeping the insertion selected for the next step
if PdfView1.FocusedFormFieldText <> '' then
  PdfView1.ReplaceFormTextAndKeepSelection('NEW');

See Also

GetSelectedFormText, SelectAllFormText, PasteFormTextFromClipboard, CutSelectedFormTextToClipboard, CopySelectedFormTextToClipboard, FormUndo, FocusedFormFieldText