GetSelectedFormText - TPdfView

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.

Component: TPdfView · Unit: PDFium

Geeft de tekst terug die momenteel is geselecteerd binnen de gefocuste AcroForm-widget op de actieve pagina van de view.

Syntaxis

function GetSelectedFormText: WString;

Beschrijving

GetSelectedFormText is een hoog niveau-ingang boven op PDFium's FORM_GetSelectedText-binding. De PDFium-API was al op unit-niveau gekoppeld, maar had tot v1.23.0 geen Pascal-vriendelijke accessor; deze methode verpakt dat netjes

De methode richt zich op elke AcroForm-widget die momenteel focus heeft op de actieve pagina van de view (dezelfde widget die op toetsenbordinvoer reageert). Wanneer de gebruiker binnen die widget een tekenreeks heeft geselecteerd — bijvoorbeeld met Shift+Arrow of via klikken en slepen — geeft GetSelectedFormText de geselecteerde tekst terug als een WString. Wanneer geen tekst is geselecteerd (alleen een caretpositie), geeft GetSelectedFormText een lege tekenreeks terug

De methode doet niets wanneer:

de view inactief is (Active = False);
het document geen AcroForm bevat (FormType = ftNone);
of er geen widget op de huidige pagina gefocust is

In alle drie gevallen is de retourwaarde een lege tekenreeks — de methode gooit nooit een exceptie

Opmerkingen

Combineer met SelectAllFormText om een menu-item "Alles selecteren" te ondersteunen en gebruik daarna GetSelectedFormText om de selectie aan Clipboard.AsText door te geven
De selectie is widget-lokaal — pagina-tekst selecteren buiten een widget levert niets op via GetSelectedFormText; gebruik daarvoor de tekstextractie-API's op tekenniveau
De selectiestatus wordt beheerd door PDFium's form-fill module; een nieuwe waarde toewijzen via FormField[i] := ... kan de selectie weer tot een cursor laten inklappen

Voorbeeld

procedure TForm1.btnCopyClick(Sender: TObject);
var
  S: WString;
begin
  S := PdfView1.GetSelectedFormText;
  if S <> '' then
    Clipboard.AsText := string(S)
  else
    ShowMessage('No form text selected');
end;

Zie ook

SelectAllFormText, FormUndo, FormRedo, FormField