ClampTextLength

Formulários, interação, unicode

Descrição

Auxiliar interno de TPDFlibFormSession que trunca um valor para no máximo um número solicitado de unidades de código UTF-16

Valores já dentro do limite passam sem alteração, e um limite não positivo produz uma string vazia

O corte cai na última fronteira de grafemo estendido no limite ou antes dele, então pares substitutos, sequências combinantes e emoji unidos nunca são divididos

/MaxLen do campo de texto ao definir o valor de edição, substituir uma seleção e confirmar um valor

Declaração

function ClampTextLength(const Value: WideString;
  MaxLength: Integer): WideString;

Parâmetros

ValueTexto a truncar
MaxLengthNúmero máximo de unidades de código UTF-16 a reter

Valor retornado

Retorna o valor inalterado quando ele cabe; caso contrário, o maior prefixo alinhado a grafema dentro do limite

Veja também

ApplySelectionEdit, CommitEdit, EnsureSelectionBoundaries, TPDFlibFormSelectionUnit, TPDFlibFormSession