Funzione Reset
Si applica a:
App Canvas App basate su modello
Reimposta il valore predefinito di un controllo, ignorando le modifiche dell'utente.
Descrizione
La funzione Reset reimposta il valore della proprietà Default di un controllo. Le eventuali modifiche apportate dagli utenti saranno rimosse.
Non è possibile reimpostare i controlli presenti in un controllo Gallery o Edit form dall'esterno degli stessi. È possibile reimpostare i controlli dalle formule in controlli all'interno della stessa raccolta o modulo. È anche possibile reimpostare tutti i controlli all'interno di un modulo con la funzione ResetForm.
L'uso della funzione Reset è un'alternativa all'attivazione e disattivazione della proprietà Reset dei controlli di input ed è in genere preferibile. La proprietà Reset potrebbe essere una scelta migliore solo qualora fosse necessario reimpostare molti controlli contemporaneamente da più formule. L'attivazione e disattivazione della proprietà Reset può essere eseguita da un controllo Button con la formula Reset = Button.Pressed o da una variabile con Reset = MyVar e l'attivazione e disattivazione di MyVar con la formula Button.OnSelect = Set( MyVar, true ); Set( MyVar, false ).
Anche i controlli di input vengono reimpostati quando la relativa proprietà Default viene modificata.
Reset non ha alcun valore di ritorno e può essere utilizzato solo nelle formule comportamentali.
Sintassi
Reimposta( Controllo )
- Controllo – Obbligatorio. Controllo da ripristinare.
Esempio
- Inserire un controllo Text input in una schermata. Per impostazione predefinita, il nome sarà TextInput1 e la relativa proprietà Default verrà impostata su "Input di testo".
- Digitare un nuovo valore nella casella di testo.
- Inserire un controllo Button sullo schermo.
- Impostare la proprietà OnSelect su Reset( TextInput1 ).
- Selezionare il pulsante. Questa operazione può essere eseguita anche durante la creazione selezionando verso l'estremità del controllo.
- Il contenuto della casella di testo restituirà il valore della proprietà Default.