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 には戻り値が存在せず、動作の数式 内でのみ使用できます。

構文

Reset( Control )

• Control – 必須。 リセットするコントロール。

例

1. Text inputコントロールを画面に挿入します。 既定では、コントロール名は TextInput1 になり、Default プロパティは Text input に設定されます。
2. テキスト ボックスに新しい値を入力します。
3. Button コントロールを画面に挿入します。
4. ボタンの OnSelect プロパティを Reset( TextInput1 ) に設定します。
5. ボタンを選択します。 コントロールを最後まで選択して作成している場合でも、ボタンを選択できます。
6. テキスト ボックスの内容が Default プロパティの値に戻ります。