GetSelectedFormText - TPdfView

Ten wpis API zachowuje identyfikatory, sygnatury, bloki kodu i terminy PDF w oryginalnej postaci.

Komponent: TPdfView · Moduł: PDFium

Zwraca tekst aktualnie zaznaczony wewnątrz aktywnego widgetu AcroForm na aktywnej stronie podglądu

Składnia

function GetSelectedFormText: WString;

Opis

GetSelectedFormText jest wysokopoziomowym punktem wejścia nad wiązaniem PDFium FORM_GetSelectedText. API PDFium było już zbindowane na poziomie jednostki, ale nie miało przyjaznego dla Pascala dostępu aż do v1.23.0; ta metoda elegancko je opakowuje

Metoda kieruje się do tego widgetu AcroForm, który aktualnie ma fokus na aktywnej stronie podglądu (tego samego widgetu, który reaguje na wejście z klawiatury). Gdy użytkownik zaznaczy w tym widgetcie zakres znaków — na przykład przez Shift+strzałki albo przeciągnięcie myszą — GetSelectedFormText zwraca tekst zaznaczenia jako WString. Gdy nie zaznaczono tekstu (jest tylko pozycja kursora), GetSelectedFormText zwraca pusty łańcuch

Metoda nie wykonuje nic, gdy:

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

We wszystkich trzech przypadkach wartością zwracaną jest pusty łańcuch — metoda nigdy nie zgłasza wyjątku

Uwagi

Połącz z SelectAllFormText, aby obsłużyć pozycję menu „Select All”, a potem użyj GetSelectedFormText do przekazania zaznaczenia do Clipboard.AsText
Zaznaczenie jest lokalne dla widgetu — zaznaczenie tekstu strony poza jakimkolwiek widgetem nie wraca przez GetSelectedFormText; do tego użyj API wyodrębniania tekstu na poziomie znaków
Stan zaznaczenia jest zarządzany przez moduł form-fill PDFium; przypisanie nowej wartości przez FormField[i] := ... może zwinąć zaznaczenie z powrotem do kursora

Przykład

procedure TForm1.btnCopyClick(Sender: TObject);
var
  S: WString;
begin
  S := PdfView1.GetSelectedFormText;
  if S <> '' then
    Clipboard.AsText := string(S)
  else
    ShowMessage('Nie zaznaczono tekstu formularza');
end;

Zobacz też

SelectAllFormText, FormUndo, FormRedo, FormField