μέθοδος GetSelectedFormText

Επιστρέφει το κείμενο που είναι επιλεγμένο εντός του εστιασμένου AcroForm widget στην ενεργή σελίδα της προβολής.

Το GetSelectedFormText είναι υψηλού επιπέδου σημείο εισόδου πάνω από το binding FORM_GetSelectedText του PDFium. Το API PDFium ήταν ήδη δεσμευμένο σε επίπεδο μονάδας αλλά δεν είχε φιλικό προς Pascal accessor μέχρι v1.23.0· αυτή η μέθοδος το τυλίγει καθαρά.

Η μέθοδος στοχεύει όποιο AcroForm widget κατέχει αυτή τη στιγμή την εστίαση στην ενεργή σελίδα της προβολής (το ίδιο widget που ανταποκρίνεται σε είσοδο πληκτρολογίου). Όταν ο χρήστης έχει επιλέξει εύρος χαρακτήρων εντός αυτού του widget — για παράδειγμα με Shift+Arrow ή κλικ-και- σύρσιμο — το GetSelectedFormText επιστρέφει το κείμενο επιλογής ως WString. Όταν δεν έχει επιλεγεί κείμενο (μόνο θέση caret), το GetSelectedFormText επιστρέφει κενή συμβολοσειρά.

Η μέθοδος είναι no-op όταν:

• η προβολή είναι ανενεργή (Active = False);
• το έγγραφο δεν φέρει AcroForm (FormType = ftNone);
• ή κανένα widget δεν είναι εστιασμένο στην τρέχουσα σελίδα.

Και στις τρεις περιπτώσεις η τιμή επιστροφής είναι κενή συμβολοσειρά — η μέθοδος δεν εγείρει ποτέ.

• Συνδυάστε με το SelectAllFormText για επιλογή της πλήρους τιμής widget, στη συνέχεια καλέστε το CopySelectedFormTextToClipboard για αμυντικό χειρισμό προχείρου Unicode
• Η επιλογή είναι τοπική στο widget — η επιλογή κειμένου σελίδας εκτός widget δεν επιστρέφει μέσω GetSelectedFormText· για αυτό χρησιμοποιήστε τα API εξαγωγής κειμένου επιπέδου χαρακτήρα.
• Η κατάσταση επιλογής διαχειρίζεται από τη μονάδα πλήρωσης φόρμας του PDFium· η εκχώρηση νέας τιμής μέσω FormField[i] := ... μπορεί να καταρρεύσει την επιλογή πίσω σε caret.

CopySelectedFormTextToClipboard, SelectAllFormText, FormUndo, FormRedo, FormField