PDFium Delphi Component 文件

ReplaceFormTextAndKeepSelection 方法

元件: TPdfView  ·  單元: PDFium
取代目前聚焦表單欄位的選取文字,並讓取代後的文字保持選取

Syntax

function ReplaceFormTextAndKeepSelection(const Text: WString): Boolean;

Parameters

TextWString. 覆寫聚焦欄位目前選取範圍的文字;傳入空字串以刪除選取範圍

Return Value

Boolean. 當可編輯的表單文字控件在作用中頁面上擁有焦點且已發出取代時為 True;呼叫為無作業時為 False

Description

以頁面的表單控制代碼呼叫 PDFium 的 FORM_ReplaceAndKeepSelection,取代檢視器作用中頁面上目前擁有焦點之表單控件內的選取文字

呼叫之後取代文字仍保持選取,而不是收合選取範圍,因此後續呼叫可以再次覆寫或延伸它。這符合原生文字控制項的輸入模型,適合 IME 組字或預測文字等漸進式、由程式驅動的輸入

傳入空字串會刪除目前的選取範圍;包裝版本會傳遞指向 NUL 寬字元的指標,因此 PDFium 永遠不會收到 nil 緩衝區

成功時會使相關聯的 TPdf 頁面場景失效並重繪檢視,因此新的欄位值會立即顯現

Remarks

Example

// 覆寫聚焦欄位中被選取的字元,
// 並讓插入內容保持選取以供後續步驟使用
if PdfView1.FocusedFormFieldText <> '' then
  PdfView1.ReplaceFormTextAndKeepSelection('NEW');

See Also

GetSelectedFormText, SelectAllFormText, PasteFormTextFromClipboard, CutSelectedFormTextToClipboard, CopySelectedFormTextToClipboard, FormUndo, FocusedFormFieldText