GetSelectedFormText - TPdfView - PDFium Delphi Component

Компонент: TPdfView · Модул: PDFium

Връща текста, маркиран в момента в AcroForm widget с фокус на активната страница на изгледа

Синтаксис

function GetSelectedFormText: WString;

Описание

GetSelectedFormText е high-level входна точка върху обвързването FORM_GetSelectedText на PDFium. PDFium API беше вече обвързано на ниво unit, но нямаше Pascal-приятелски достъп до v1.23.0; този метод го обвива чисто

Методът цели какъвто и да е AcroForm widget, който в момента притежава фокуса на активната страница на изгледа (същият widget, който отговаря на клавиатурен вход). Когато потребителят е маркирал диапазон от символи в този widget — например чрез Shift+Стрелка или клик и влачене — GetSelectedFormText връща маркирания текст като WString. Когато не е маркиран текст (само позиция на карета), GetSelectedFormText връща празен низ

Методът не прави нищо, когато:

изгледът е неактивен (Active = False);
документът няма AcroForm (FormType = ftNone);
или нито един widget няма фокус на текущата страница

И в трите случая връщаната стойност е празен низ — методът никога не вдига изключение

Забележки

Комбинирайте с SelectAllFormText, за да маркирате пълната стойност на widget, после извикайте CopySelectedFormTextToClipboard за защитено Unicode копиране в клипборда
Маркирането е локално за widget — маркиран текст на страница извън който и да е widget не се връща чрез GetSelectedFormText; за това използвайте API за извличане на текст на ниво символ
Състоянието на маркиране се управлява от form-fill модула на PDFium; задаване на нова стойност чрез FormField[i] := ... може да свие маркирането обратно до карета

Пример

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

Виж също

CopySelectedFormTextToClipboard, SelectAllFormText, FormUndo, FormRedo, FormField