GetSelectedFormText 方法

GetSelectedFormText 是 PDFium 的 FORM_GetSelectedText 绑定之上的高层入口。该 PDFium API 早已在单元级完成绑定， 但在 v1.23.0 之前一直没有 Pascal 友好的访问器；这个方法对其进行了干净的封装

该方法作用于视图活动页面上当前拥有焦点的 AcroForm 控件 （即响应键盘输入的同一控件）。当用户在该控件内选中了一段字符 — 例如通过 Shift+方向键或点击拖拽 — GetSelectedFormText 会以 WString 返回选中的文本。当没有选中文本（仅有插入符位置）时， GetSelectedFormText 返回空字符串

在以下情况下该方法不做任何事：

• 视图处于非活动状态（Active = False）；
• 文档不包含 AcroForm（FormType = ftNone）；
• 或者当前页面上没有控件拥有焦点

在以上三种情况下返回值都是空字符串 — 该方法从不抛出异常

• 与 SelectAllFormText 配合可选择完整的控件值，然后调用 CopySelectedFormTextToClipboard 以获得防御性的 Unicode 剪贴板处理
• 选中范围是控件局部的 — 在任何控件之外选择页面文本不会通过 GetSelectedFormText 返回；这类需求请使用字符级文本提取 API
• 选中状态由 PDFium 的表单填充模块管理；通过 FormField[i] := ... 赋新值可能使选中范围收缩回插入符