function ReplaceFormTextAndKeepSelection(const Text: WString): Boolean;
| Text | WString. フォーカスされているフィールドの現在の選択範囲に上書きするテキストです。空の文字列を渡すと選択範囲を削除します |
ビューアのアクティブページで現在フォーカスを保持しているフォームウィジェット内の選択テキストを置き換えます。置き換えは、ページのフォームハンドルを渡して PDFium の FORM_ReplaceAndKeepSelection を呼び出すことで行われます
置き換え後のテキストは、選択を折りたたむのではなく呼び出し後も選択されたままになるため、続く呼び出しで再度上書きや範囲拡張を行えます。これはネイティブテキストコントロールの入力モデルと一致し、IME 変換や予測テキストのようなコード駆動のインクリメンタル入力に適します
空の文字列を渡すと現在の選択範囲が削除されます。ラッパーは NUL ワイド文字へのポインタを渡すため、PDFium が nil バッファを受け取ることはありません
成功すると、関連する TPdf ページシーンが無効化され、ビューが再描画するため、新しいフィールド値が直ちに表示されます
permFillForms または permModify 権限がない場合、フォーカスを保持するウィジェットがない場合、フォーカスされたウィジェットが別のページにある場合には、ドキュメントに触れずに False を返しますfiTextField であるか、ffChoiceEdit フラグ付きの fiComboBox であること、かつ ffReadOnly を持たないことが条件ですFormHandle を直接経由するため、ユーザーのフォーム入力が無効化されていてもプログラムによる編集は機能し続けます// Overtype the selected characters of the focused field,
// keeping the insertion selected for the next step
if PdfView1.FocusedFormFieldText <> '' then
PdfView1.ReplaceFormTextAndKeepSelection('NEW');