API version 1
- ‐

Validate

値が確定する前に発生するイベントです。 入力値を検査し確定させるか、拒否するかを選択することができます。

ValidateイベントのEventオブジェクトは以下の構造を持ちます。

名前 説明
Primitive currentValue 現在の値
Primitive newValue 変更しようとしている値

TextBox において、inputModeにINPUT_MASKを指定している場合、format指定に合致しない場合newValueプロパティは空になります。


return値として以下を戻すことで動作を指定できます。

定数値 説明
VALIDATE_ACCEPT 0:新しい値を受け入れて確定します。
VALIDATE_REJECT 1:新しい値を拒否し、未確定のままにします。
VALIDATE_REVERT 2:新しい値を拒否し値を元のValue値にもどします。