GetSelectedFormText - TPdfView - PDFium Delphi Component

Komponenta: TPdfView · Jednotka: PDFium

Vrací text aktuálně vybraný uvnitř zaměřeného widgetu AcroForm na aktivní stránce pohledu

Syntaxe

function GetSelectedFormText: WString;

Popis

GetSelectedFormText je vysokoúrovňový vstupní bod nad vazbou FORM_GetSelectedText PDFia. Toto PDFium API bylo na úrovni jednotky svázáno už dříve, ale do v1.23.0 nemělo přívětivý přístup pro Pascal; tato metoda ho čistě obaluje

Metoda míří na widget AcroForm, který aktuálně vlastní fokus na aktivní stránce pohledu (tentýž widget, který reaguje na vstup z klávesnice). Když uživatel uvnitř tohoto widgetu vybral rozsah znaků — například pomocí Shift+Šipka nebo tažením myší — GetSelectedFormText vrátí text výběru jako WString. Když není vybrán žádný text (jen pozice kurzoru), vrátí GetSelectedFormText prázdný řetězec

Metoda nemá žádný účinek, když:

pohled je neaktivní (Active = False);
dokument nemá AcroForm (FormType = ftNone);
nebo není na aktuální stránce zaměřen žádný widget

Ve všech třech případech je návratovou hodnotou prázdný řetězec — metoda nikdy nevyvolá výjimku

Poznámky

Spojte s SelectAllFormText, abyste vybrali kompletní hodnotu widgetu, a poté zavolejte CopySelectedFormTextToClipboard pro bezpečnou obsluhu schránky v Unicode
Výběr je lokální v rámci widgetu — výběr textu stránky mimo jakýkoli widget se přes GetSelectedFormText nevrací; k tomu použijte API pro extrakci textu na úrovni znaků
Stav výběru spravuje modul vyplňování formulářů PDFia; přiřazení nové hodnoty přes FormField[i] := ... může sbalit výběr zpět na kurzor

Příklad

procedure TForm1.btnCopyClick(Sender: TObject);
begin
if not PdfView1.CopySelectedFormTextToClipboard then
ShowMessage('No form text selected');
end;

Viz také

CopySelectedFormTextToClipboard, SelectAllFormText, FormUndo, FormRedo, FormField