ApplySelectionEdit

Formulários, interação, histórico de edições

Descrição

Auxiliar interno de TPDFlibFormSession que executa a transação atômica de substituição por trás de ReplaceSelection, CutSelection e PasteText

Apenas campos de texto e campos de escolha editáveis do tipo de escolha 4 são aceitos, e campos somente leitura são rejeitados

/K do widget e depois dispara OnTextEdit com o tipo de edição, a seleção UTF-16, o texto selecionado e uma substituição mutável; qualquer veto aborta com 0 antes que o valor transitório mude Para campos de texto, um

Para campos de texto, um /MaxLen configurado é imposto limitando a substituição ao comprimento restante, cortando apenas em fronteiras completas de grafemo estendido

Uma substituição aceita insere o valor, recolhe o cursor depois do texto inserido, registra uma entrada no histórico e retorna o texto removido por RemovedText

Declaração

function ApplySelectionEdit(EditKind: TPDFlibFormEditKind;
  const ReplacementText: WideString; out RemovedText: WideString): Integer;

Parâmetros

EditKindTipo relatado a OnTextEdit: um de fekReplaceSelection, fekCutSelection ou fekPasteText
ReplacementTextTexto que substitui a seleção normalizada
RemovedTextRecebe o texto anteriormente selecionado em caso de sucesso; caso contrário, uma string vazia

Valor retornado

Retorna 1 quando a substituição foi aceita; caso contrário, 0 quando a solicitação era reentrante, nenhum campo editável está ativo, o campo é somente leitura ou a ação /K ou o manipulador OnTextEdit vetou

Veja também

ReplaceSelection, CutSelection, PasteText, DeleteEditSelection, DispatchAction, ClampTextLength, AddEditHistory, TPDFlibFormEditKind, TPDFlibFormSessionTextEditEvent, TPDFlibFormSession