Funkce Reset
Platí pro:
aplikace plátna modelem řízené aplikace
Resetuje ovládací prvek na jeho výchozí hodnotu, přičemž zahodí všechny změny provedené uživatelem.
Popis
Funkce Reset obnoví ovládací prvek na jeho hodnotu vlastnosti Default. Všechny změny provedené uživatelem se zahodí.
Ovládací prvky, které jsou uvnitř ovládacího prvku Gallery nebo Edit form, nemůžete resetovat z vnějšku těchto dvou ovládacích prvků. Ovládací prvky můžete resetovat ze vzorců v ovládacích prvcích uvnitř stejné galerie nebo formuláře. Všechny ovládací prvky ve formuláři můžete resetovat najednou pomocí funkce ResetForm.
Použití funkce Reset představuje alternativu k přepínání vlastnosti Reset ovládacích prvků pro zadávání a je obecně upřednostňované. Použití vlastnosti Reset může být výhodnější v případě, že je potřeba současně resetovat mnoho ovládacích prvků z více vzorců. Vlastnost Reset se dá přepnout z ovládacího prvku Button pomocí vzorce Reset = Button.Pressed nebo z proměnné pomocí Reset = MyVar a přepnutím proměnné MyVar pomocí vzorce Button.OnSelect = Set( MyVar; true ) nebo Set( MyVar; false ).
Ovládací prvky pro zadávání se také resetují, když se změní jejich vlastnost Default.
Funkce Reset nemá žádnou návratovou hodnotu a můžete ji použít jenom ve vzorcích chování.
Syntaxe
Reset( Ovládací prvek )
- Ovládací prvek – povinný argument. Ovládací prvek, který chcete resetovat.
Příklad
- Vložte na obrazovku ovládací prvek pro Text input. Jeho výchozí název bude TextInput1 a jeho vlastnost Default bude nastavená na "Text input".
- Zadejte do textového pole novou hodnotu.
- Vložte na obrazovku ovládací prvek Button.
- Nastavte vlastnost OnSelect tlačítka na Reset( TextInput1 ).
- Vyberte tlačítko. Dá se to udělat dokonce i při vytváření – výběrem ke koncům ovládacího prvku.
- Obsah textového pole se vrátí k hodnotě vlastnosti Default.