GetSelectedFormText Metoda

GetSelectedFormText to wysokopoziomowy punkt wejściowy zbudowany nad powiązaniem FORM_GetSelectedText biblioteki PDFium. Interfejs PDFium był już związany na poziomie modułu, ale do wersji v1.23.0 nie miał przyjaznego Pascalowi akcesora; ta metoda opakowuje go w czysty sposób.

Metoda odnosi się do widgetu AcroForm, który aktualnie posiada fokus na aktywnej stronie widoku (ten sam widget, który reaguje na wejście z klawiatury). Gdy użytkownik zaznaczy zakres znaków wewnątrz tego widgetu — na przykład przez Shift+Strzałka lub kliknięcie i przeciągnięcie — GetSelectedFormText zwraca tekst zaznaczenia jako WString. Gdy żaden tekst nie jest zaznaczony (tylko pozycja kursora tekstowego), GetSelectedFormText zwraca pusty ciąg.

Metoda nie wykonuje żadnej operacji, gdy:

• widok jest nieaktywny (Active = False);
• dokument nie zawiera AcroForm (FormType = ftNone);
• lub żaden widget nie ma fokusu na bieżącej stronie.

We wszystkich trzech przypadkach zwracana wartość to pusty ciąg — metoda nigdy nie zgłasza wyjątku.

• Połącz z SelectAllFormText, aby zaznaczyć całą wartość widgetu, a następnie wywołaj CopySelectedFormTextToClipboard dla bezpiecznej obsługi schowka Unicode
• Zaznaczenie jest lokalne dla widgetu — zaznaczenie tekstu strony poza dowolnym widgetem nie wraca przez GetSelectedFormText; w tym celu użyj interfejsów API ekstrakcji tekstu na poziomie znaków.
• Stan zaznaczenia jest zarządzany przez moduł wypełniania formularzy PDFium; przypisanie nowej wartości przez FormField[i] := ... może zwinąć zaznaczenie z powrotem do kursora tekstowego.