SetEditValue

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

Descrição

Substitui todo o valor transitório da edição ativa por uma cadeia fornecida pelo chamador

Nos campos de texto de linha única ou multilinha com comprimento máximo configurado, o valor é truncado num limite completo de grafema expandido, pelo que nenhum par substituto ou sequência combinante é dividido

A alteração atualiza DisplayValue, limita a seleção direcionada ao novo valor, recalcula Modified e regista uma entrada de diferenças de valor inteiro para anular

Declaração

function SetEditValue(const NewValue: WideString): Integer;

Parâmetros

NewValueValor transitório de substituição, limitado ao comprimento máximo do campo quando este está configurado

Valor devolvido

Devolve 1 quando o valor foi guardado e 0 quando não há edição ativa ou a sessão está a aplicar uma edição, um passo do histórico ou uma confirmação

Exemplo

Session.BeginEdit(FieldIndex);
Session.SetEditValue('New content');

Consulte também

EditValue, RecordEditHistory, ClampTextLength, BeginEdit, CommitEdit