ClampTextLength

表單、互動、Unicode

描述

TPDFlibFormSession 的內部輔助方法,把值截斷到最多指定的 UTF-16 code unit 數

已在限制內的值原樣通過,非正數的限制會得到空字串

裁切點落在限制處或之前最後一個擴展字位邊界,因此代理對、組合序列與接合的 emoji 都不會被切開

此輔助方法在設定編輯值、取代選取範圍與提交值時,強制執行文字欄位的 /MaxLen 限制

宣告

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

參數

Value要截斷的文字
MaxLength要保留的 UTF-16 碼元數量上限

傳回值

值在限制內時原樣傳回,否則傳回限制內最長的字素對齊前置字元

另請參閱

ApplySelectionEdit, CommitEdit, EnsureSelectionBoundaries, TPDFlibFormSelectionUnit, TPDFlibFormSession