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 Reset funzione reimposta un controllo sul valore della proprietà Default . 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 Reset funzione è un'alternativa alla disattivazione della Reset proprietà dei controlli di input ed è in genere preferibile. La Reset proprietà può essere una scelta migliore se molti controlli devono essere reimpostati insieme da più formule. Attivare o disattivare la Reset proprietà da un controllo Button con la formula Reset = Button.Pressed o da una variabile con Reset = MyVar e attivare o disattivare 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 restituito ed è possibile usarlo solo nelle formule di comportamento.

Sintassi

Reset( Controllo )

• Controllo – Obbligatorio. Controllo da ripristinare.

Esempio

1. 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".
2. Digitare un nuovo valore nella casella di testo.
3. Inserire un controllo Button sullo schermo.
4. Impostare la proprietà OnSelect del pulsante su Reset( TextInput1 ).
5. Selezionare il pulsante. Questa operazione può essere eseguita anche durante la creazione selezionando verso l'estremità del controllo.
6. Il contenuto della casella di testo restituirà il valore della proprietà Default.