GetSelectedFormText method

Vrne besedilo, ki je trenutno izbrano znotraj osredotočenega gradnika AcroForm na aktivni strani pogleda

GetSelectedFormText je visokoravenska vstopna točka nad vezjo FORM_GetSelectedText PDFium-a. API PDFium je bil na ravni enote že vezan, vendar do v1.23.0 ni imel Pascal prijaznega dostopnika; ta metoda ga čisto ovije.

Metoda cilja na tisti gradnik AcroForm, ki na aktivni strani pogleda trenutno drži fokus (isti gradnik, ki se odziva na tipkovnico). Ko je uporabnik znotraj tega gradnika izbral obseg znakov — na primer s Shift+puščica ali klikom in vlečenjem — GetSelectedFormText vrne besedilo izbire kot WString. Kadar ni izbranega besedila (samo položaj kazalke), GetSelectedFormText vrne prazen niz.

Metoda je brez učinka, kadar:

• je pogled neaktiven (Active = False);
• dokument nima AcroForm (FormType = ftNone);
• ali na trenutni strani ni gradnika v fokusu.

V vseh treh primerih je vrnjena vrednost prazen niz — metoda nikoli ne sproži izjeme.

• Za podporo menijskega vnosa "Izberi vse" jo združite z SelectAllFormText, nato pa za obrambno ravnanje z odložiščem Unicode pokličite CopySelectedFormTextToClipboard
• Izbira je lokalna za gradnik — izbira besedila strani zunaj katerega koli gradnika se ne vrne prek GetSelectedFormText; za to uporabite API-je za izluščitev besedila na ravni znakov.
• Stanje izbire upravlja modul izpolnjevanja obrazcev PDFium; dodelitev nove vrednosti prek FormField[i] := ... lahko strne izbiro nazaj v kazalko.

CopySelectedFormTextToClipboard, SelectAllFormText, FormUndo, FormRedo, FormField