Reset 関数

適用対象: キャンバス アプリ モデル駆動型アプリ

ユーザーによる変更を破棄して、コントロールを既定値にリセットします。

内容

Reset関数は、コントロールを Default プロパティ値にリセットします。 ユーザーによる変更は破棄されます。

Gallery または Edit form コントロール内のコントロールは、そのコントロールの外部からはリセットできません。 同じギャラリーまたはフォーム内なら、コントロールの数式でコントロールをリセットできます。 ResetForm 関数を使用して、フォーム内のすべてのコントロールをリセットすることもできます。

Reset関数の使用は、入力コントロールのResetプロパティを切り替える代わりに使用するのが一般的です。 多くのコントロールを複数の数式から一緒にリセットする必要がある場合は、 Reset プロパティを使用することをお勧めします。 Resetプロパティの切り替えは、式が Reset = Button.Pressed の Button コントロールから、または Reset = MyVar の変数から行い、式 Button.OnSelect = Set( MyVar, true )で MyVar を切り替えることができます。Set( MyVar, false ).

Default プロパティが変更されると、入力コントロールもリセットされます。

Reset には戻り値がないため、 動作の数式でのみ使用できます。

構文

Reset( コントロール )

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

例

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