ClampTextLength

フォーム、インタラクション、Unicode

説明

TPDFlibFormSessionの内部ヘルパーで、値を要求されたUTF-16コードユニット数以内へ切り詰めます

既に制限内の値はそのまま通過し、正でない制限は空文字列を返します

切り詰め位置は制限以内の最後の拡張グラフェム境界に落ちるため、サロゲートペア、結合シーケンス、結合絵文字が分割されることはありません

ヘルパーは編集値の設定、選択の置換、値のコミットの際にテキストフィールドの/MaxLen制限を強制します

宣言

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

パラメータ

Value切り詰めるテキスト
MaxLength保持するUTF-16コードユニットの最大数

戻り値

収まる場合は変更されない値を返し、それ以外では上限内の最長の書記素整列プレフィックスを返します

関連項目

ApplySelectionEdit, CommitEdit, EnsureSelectionBoundaries, TPDFlibFormSelectionUnit, TPDFlibFormSession