PDFium Delphi Component 文件

ReplaceFormTextAndKeepSelection 方法

组件: TPdfView  ·  单元: PDFium
替换当前获得焦点的表单字段中被选中的文本,并使替换后的文本保持选中

语法

function ReplaceFormTextAndKeepSelection(const Text: WString): Boolean;

参数

TextWString。写入焦点字段当前选中位置的文本;传入空字符串表示删除选中内容

返回值

Boolean。当活动页面上有可编辑的表单文本控件拥有焦点且替换已发出时为 True;调用为无操作时为 False

说明

通过使用页面的表单句柄调用 PDFium 的 FORM_ReplaceAndKeepSelection,替换查看器活动页面上当前拥有焦点的表单控件内被选中的文本

调用之后替换文本保持选中而不是使选中范围坍缩,因此后续调用可以继续覆写或扩展它。这符合原生文本控件的输入模型,适合输入法组词或预测文本这类增量式、由代码驱动的输入

传入空字符串会删除当前选中内容;封装层会传入指向 NUL 宽字符的指针,因此 PDFium 永远不会收到 nil 缓冲区

成功时关联的 TPdf 页面场景会失效并触发视图重绘,因此新的字段值立即可见

备注

示例

// 覆写焦点字段中被选中的字符,
// 并保持插入内容选中以便下一步操作
if PdfView1.FocusedFormFieldText <> '' then
  PdfView1.ReplaceFormTextAndKeepSelection('NEW');

参见

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