CutSelection

Formulários, interação, Unicode

Descrição

Copia a seleção normalizada para CutText e a remove pelo caminho atômico de substituição de texto da sessão

O método não tem dependência da área de transferência do sistema operacional, permitindo que hosts VCL, FMX, serviços e multiplataforma escolham seu próprio adaptador de área de transferência

Se /K ou OnTextEdit vetar a edição, CutText fica vazio e a seleção permanece inalterada

Declaração

function CutSelection(out CutText: WideString): Integer;

Parâmetros

CutText	Recebe o texto UTF-16 removido somente depois que a edição é aceita

Valor retornado

Retorna 1 quando a transação de corte é aceita, inclusive com uma seleção vazia; caso contrário, 0

Exemplo

if Session.CutSelection(ClipboardText) = 1 then
  HostClipboard.SetText(ClipboardText);

Veja também

ReplaceSelection, PasteText, GetSelectionRange, TPDFlibFormSession