PDFium Delphi Component Docs

ReplaceFormTextAndKeepSelection Método

Componente: TPdfView  ·  Unidade: PDFium
Substitui o texto selecionado do campo de formulário em foco no momento e mantém a substituição selecionada

Syntax

function ReplaceFormTextAndKeepSelection(const Text: WString): Boolean;

Parameters

TextWString. Texto gravado sobre a seleção atual do campo em foco; passe uma string vazia para excluir a seleção

Return Value

Boolean. True quando um widget de texto de formulário editável tem o foco na página ativa e a substituição foi emitida; False quando a chamada não tem efeito

Description

Substitui o texto selecionado no momento dentro do widget de formulário que atualmente tem o foco na página ativa do visualizador, chamando FORM_ReplaceAndKeepSelection do PDFium com o handle de formulário da página

O texto de substituição permanece selecionado após a chamada, em vez de recolher a seleção, de modo que uma chamada seguinte pode sobrescrevê-lo ou estendê-lo novamente. Isso corresponde ao modelo de digitação de um controle de texto nativo e serve a entrada incremental dirigida por código, como composição de IME ou texto preditivo

Passar uma string vazia exclui a seleção atual; o wrapper passa um ponteiro para um caractere largo NUL para que o PDFium nunca receba um buffer nil

Em caso de sucesso, a cena de página do TPdf associada é invalidada e o visualizador é repintado, de modo que o novo valor do campo fica visível imediatamente

Remarks

Example

// Sobrescreve os caracteres selecionados do campo em foco,
// mantendo a inserção selecionada para a próxima etapa
if PdfView1.FocusedFormFieldText <> '' then
  PdfView1.ReplaceFormTextAndKeepSelection('NEW');

See Also

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