ReplaceSelection

Formulários, interação, Unicode

Descrição

Substitui a seleção normalizada no campo de texto ativo ou caixa de combinação editável e recolhe o cursor após a substituição aceita A sessão primeiro despacha a ação

A sessão primeiro despacha a ação /K do campo por meio de OnAction e, então, chama OnTextEdit com o texto selecionado e uma substituição mutável

Um veto deixa o valor de edição, a seleção, o estado modificado e o campo do documento inalterados

/MaxLen de campo de texto preservam o prefixo e o sufixo existentes, truncam apenas o texto inserido e nunca dividem um cluster de grafema estendido

Declaração

function ReplaceSelection(
  const ReplacementText: WideString): Integer;

Parâmetros

ReplacementTextTexto proposto para a seleção normalizada atual antes da modificação do host e da imposição de comprimento

Valor de retorno

Retorna 1 quando a substituição é aceita, incluindo uma substituição sem efeito; caso contrário, 0

Exemplo

if Session.SetSelectionRange(1, 3, fsuGraphemeCluster) = 1 then
  Session.ReplaceSelection('approved');

Consulte também

CutSelection, PasteText, SetSelectionRange, TPDFlibFormSession