[この記事はプレリリース ドキュメントであり、変更されることがあります。]
Important
これは試験段階の機能です。 詳細については、「 試験段階の機能とプレビュー機能」を参照してください。
イベントによってコンポーネント インスタンスの変更がトリガーされたときに実行される 1 つ以上の 動作式 を指定します。
たとえば、コンポーネントの OnReset プロパティを、初期化とクリアの入力を行う 1 つ以上の数式に設定します。 Reset 関数がコンポーネント インスタンスで実行されている場合に値を リセット します。
注
カスタム動作プロパティを作成する機能は、現在試験段階です。 ただし、運用環境のすべてのコンポーネントで使用できる既定の OnReset プロパティを使用できます。
OnReset
コンポーネント マスターを選択した状態で、プロパティのドロップダウン リスト (数式バーの左側) で [OnReset ] を選択し、1 つ以上の数式を入力します。
OnReset をテストするには、コンポーネントをリセットするコントロールを構成します。 たとえば、ボタンの OnSelect プロパティを Reset(ComponentName) という数式に設定します。
例 - タイマーのリセット
この時間選択コンポーネントでは、時刻_selectedHourと_selectedMinuteを表示するために 2 つの変数が使用されます。 ピッカーがリセットされたら、これらの変数を既定値 (12: 12 など) にリセットする必要があります。 コンポーネントの OnReset プロパティには、次の数式があります: Set(_selectedHour,12);Set(_selectedMinute,12)
リセットをトリガーするには、画面に移動し、コンポーネントのインスタンスを挿入します。 ボタンを追加し、ボタンの OnSelect を構成して Reset(TimerComponent_instance) を呼び出して OnReset をトリガーします。
![[リセット] ボタン。](media/component-behavior/reset-button.png "[リセット] ボタン")
カスタム プロパティを使用して OnReset を更新する
コンポーネントの外部からコンポーネント インスタンスをリセットするだけでなく、内部から OnReset をトリガーする別のメソッドもあります。 "値が変更されたときに OnReset を発生させる" は、カスタム入力プロパティを作成するときのオプションです。 これにより、このプロパティの値の変更によって、コンポーネントの OnReset がトリガーされます。 このメソッドは、既定値を簡単に設定およびリセットするように設計されています。
Example
上記の例は、注文番号の確認と番号の更新を示しています。 数値の上下のコンポーネントは、注文数の増減に使用されます。 左側のギャラリーを選択すると、選択したツールの順序番号を表示するために、数値の上下コンポーネントの既定の番号がリセットされます。 値が変更されたときに OnReset を発生 させ、入力が変更されたときに既定値をリセットできるようにします。
これを行うには、既定の入力プロパティの 値が変更されたときに[OnReset を発生させる] チェック ボックスをオンにします。 コンポーネントの OnReset は Set(_numericValue, 'Numeric up down'.DefaultValue) に設定されています。 _numericValueは、現在の注文値の値を格納する変数です。 テキスト入力コントロールの既定値をIf(IsBlank(_numericValue), 'Numeric up down'.DefaultValue, _numericValue)に設定します。