GetSelectedFormText - TPdfView - PDFium Delphi Component

元件: TPdfView · 單元: PDFium

回傳檢視器作用中頁面上，目前取得焦點之 AcroForm 控件內的已選取文字

Syntax

function GetSelectedFormText: WString;

Description

GetSelectedFormText 是建構在 PDFium FORM_GetSelectedText 繫結之上的高階進入點。該 PDFium API 早已在單元層級繫結，但直到 v1.23.0 才有 Pascal 友善的存取子；此方法將其乾淨地包裝起來

此方法的作用對象是檢視器作用中頁面上目前擁有焦點的 AcroForm widget（即回應鍵盤輸入的同一個 widget）。當使用者在該 widget 內選取了一段字元 — 例如以 Shift+方向鍵或點選拖曳 — GetSelectedFormText 會以 WString 傳回選取的文字。當沒有選取任何文字（只有游標位置）時，GetSelectedFormText 傳回空字串

此方法在下列情況下不執行任何操作：

檢視器非作用中（Active = False）
文件沒有 AcroForm（FormType = ftNone）
或目前頁面上沒有 widget 取得焦點

在三種情況下傳回值都是空字串 — 此方法永不引發例外

Remarks

與 SelectAllFormText 搭配以選取完整的 widget 值，接著呼叫 CopySelectedFormTextToClipboard 進行防禦性的 Unicode 剪貼簿處理
選取是 widget 區域性的 — 在任何 widget 之外選取頁面文字不會透過 GetSelectedFormText 傳回；請使用字元層級的文字擷取 API
選取狀態由 PDFium 的表單填寫模組管理；透過 FormField[i] := ... 指派新值可能會讓選取收合成單一游標

Example

procedure TForm1.btnCopyClick(Sender: TObject);
var
  S: WString;
begin
  S := PdfView1.GetSelectedFormText;
  if S <> '' then
    Clipboard.AsText := string(S)
  else
    ShowMessage('No form text selected');
end;

GetSelectedFormText 方法

元件: TPdfView · 單元: PDFium

Syntax

Description

Remarks

Example

See Also