PDFium Delphi Component Docs

ReplaceFormTextAndKeepSelection Methode

Komponente: TPdfView  ·  Unit: PDFium
Ersetzt den ausgewählten Text des aktuell fokussierten Formularfelds und lässt die Ersetzung ausgewählt

Syntax

function ReplaceFormTextAndKeepSelection(const Text: WString): Boolean;

Parameter

TextWString. Text, der über die aktuelle Auswahl des fokussierten Felds geschrieben wird; übergeben Sie einen leeren String, um die Auswahl zu löschen

Rückgabewert

Boolean. True, wenn auf der aktiven Seite ein editierbares Formular-Text-Widget den Fokus besitzt und die Ersetzung ausgelöst wurde; False, wenn der Aufruf ein No-op ist

Beschreibung

Ersetzt den aktuell ausgewählten Text in dem Formular-Widget, das auf der aktiven Seite des Viewers den Fokus besitzt, indem PDFiums FORM_ReplaceAndKeepSelection mit dem Formular-Handle der Seite aufgerufen wird

Der Ersetzungstext bleibt nach dem Aufruf ausgewählt, statt dass die Auswahl zusammenfällt, sodass ein nachfolgender Aufruf erneut überschreiben oder erweitern kann. Das entspricht dem Eingabemodell eines nativen Text-Steuerelements und eignet sich für inkrementelle, codegesteuerte Eingaben wie IME-Komposition oder Vorhersagetext

Ein leerer String löscht die aktuelle Auswahl; der Wrapper übergibt einen Zeiger auf ein NUL-Breitzeichen, damit PDFium niemals einen nil-Puffer erhält

Bei Erfolg wird die zugehörige TPdf-Seitenszene ungültig gemacht und die Ansicht zeichnet neu, sodass der neue Feldwert sofort sichtbar wird

Hinweise

Beispiel

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

Siehe auch

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