Funkcja Reset

  • Artykuł

Dotyczy: aplikacje kanwy aplikacje oparte na modelu

Umożliwia zresetowanie kontrolki do jej wartości domyślnej przez odrzucenie zmian wprowadzonych użytkownika.

Opis

Funkcja Reset umożliwia zresetowanie kontrolki za pomocą wartości jej właściwości Default. Wszelkie zmiany użytkownika zostaną odrzucone.

Kontrolek znajdujących się w kontrolkach Gallery i Edit form nie można zresetować spoza tych kontrolek. Kontrolki można zresetować z poziomu formuł w kontrolkach w tej samej galerii lub w tym samym formularzu. Inna możliwość to zresetowanie wszystkich kontrolek w formularzu za pomocą funkcji ResetForm.

Funkcja Reset to metoda alternatywna do przełączenia właściwości Reset kontrolek wejściowych i jest to ogólnie metoda preferowana. Właściwość Reset może być lepszym rozwiązaniem, jeśli trzeba zresetować wiele kontrolek jednocześnie z wielu formuł. Przełączenie właściwości Reset można wykonać z poziomu kontrolki Button przy użyciu formuły Reset = Button.Pressed lub z poziomu zmiennej za pomocą formuły Reset = MyVar, przełączając zmienną MyVar przy użyciu formuły Button.OnSelect = Set( MyVar, true ); Set( MyVar, false ).

Kontrolki wejściowe są także resetowane w przypadku zmiany ich właściwości Default.

Funkcja Reset nie zwraca żadnej wartości i można jej używać wyłącznie w formułach zachowania.

Składnia

Reset( Kontrolka )

  • Kontrolka – wartość wymagana. Kontrolka do zresetowania.

Przykład

  1. Wstaw kontrolkę Text input na ekranie. Jej nazwa domyślna to TextInput1, a wartość jej właściwości Default to "Text input".
  2. Wpisz nową wartość w polu tekstowym.
  3. Wstaw kontrolkę Button na ekranie.
  4. Ustaw dla właściwości OnSelect przycisku formułę Reset( TextInput1 ).
  5. Wybierz przycisk. Można to zrobić nawet w trakcie edycji, wybierając przy brzegach kontrolki.
  6. Zawartość pola tekstowego zostanie zmieniona z powrotem na wartość właściwości Default.