Reset 関数
適用対象: キャンバス アプリ モデル駆動型アプリ
ユーザーによる変更を破棄して、コントロールを既定値にリセットします。
内容
Reset 関数は、コントロールを Default プロパティの値にリセットします。 ユーザーによる変更は破棄されます。
Gallery または Edit form コントロール内のコントロールは、そのコントロールの外部からはリセットできません。 同じギャラリーまたはフォーム内なら、コントロールの数式でコントロールをリセットできます。 ResetForm 関数を使用して、フォーム内のすべてのコントロールをリセットすることもできます。
Reset 関数を使用することは、入力コントロールの Reset プロパティを切り替えるための代替手段であり、一般的に好まれるやり方です。 Reset プロパティは、複数の数式で多くのコントロールをまとめてリセットする必要がある場合に適した方法です。 Reset プロパティの切り替えは、Button コントロールで Reset = Button.Pressed という数式を使用することにより、または変数で Reset = MyVar の MyVar を Button.OnSelect = Set( MyVar, true ); Set( MyVar, false ) という数式を使用して切り替えることにより、行うことができます。
Default プロパティが変更されると、入力コントロールもリセットされます。
Reset には戻り値がなく、動作の数式でのみ使用できます。 ...
構文
リセット( 制御 )
- コントロール – 必須。 リセットするコントロール。
例
- Text inputコントロールを画面に挿入します。 既定では、コントロール名は TextInput1 になり、Default プロパティは Text input に設定されます。
- テキスト ボックスに新しい値を入力します。
- Button コントロールを画面に挿入します。
- ボタンの OnSelect プロパティを Reset( TextInput1 ) に設定します。
- ボタンを選択します。 コントロールを最後まで選択して作成している場合でも、ボタンを選択できます。
- テキスト ボックスの内容が Default プロパティの値に戻ります。