Modificano o creano un elemento, salvano il contenuto e reimpostano i controlli in un controllo Edit form.

Descrizione

Queste funzioni sono spesso chiamate dalla formula OnSelect di un controllo Button o Image in modo che l'utente possa salvare le modifiche, ignorare le modifiche o creare un record. È possibile usare i controlli insieme a queste funzioni per creare una soluzione completa.

Queste funzioni non restituiscono valori.

SubmitForm

Usare la funzione SubmitForm nella proprietà OnSelect del controllo Button per salvare le modifiche in un controllo Form nell'origine dati.

Prima di inviare le modifiche, questa funzione controlla i problemi di convalida con qualsiasi campo contrassegnato come obbligatorio oppure con un campo che include uno o più vincoli nel relativo valore. Questo comportamento è identico a quello della funzione Validate.

SubmitForm controlla anche la proprietà Valid di Form, che è un'aggregazione di tutte le proprietà Valid dei controlli Card contenuti dal controllo Form. Se si verifica un problema, i dati non vengono inviati e le proprietà Error e ErrorKind del controllo Form vengono impostate di conseguenza.

Se la convalida riesce, SubmitForm invia la modifica all'origine dati.

  • Se ha esito positivo, viene eseguito il comportamento della proprietà OnSuccess di Form e le proprietà Error e ErrorKind vengono cancellate. Se il modulo fosse in modalità FormMode.New, ritornerebbe alla modalità FormMode.Edit.
  • Se ha esito negativo, viene eseguito il comportamento della proprietà OnFailure di Form e le proprietà Error e ErrorKind vengono impostate di conseguenza. La modalità del modulo rimane invariata.

EditForm

La funzione EditForm modifica la modalità del controllo Form in FormMode.Edit. In questa modalità, il contenuto della proprietà Item del controllo Form viene usato per compilare il modulo. Se la funzione SubmitForm viene eseguita quando Form è in questa modalità, viene modificato, ma non creato, un record. FormMode.Edit è il valore predefinito per il controllo Form.

NewForm

La funzione NewForm modifica la modalità del controllo Form in FormMode.New. In questa modalità, il contenuto della proprietà Item del controllo Form viene ignorato e i valori predefiniti della proprietà DataSource di Form compilano il modulo. Se la funzione SubmitForm viene eseguita quando il modulo è in questa modalità, viene creato, ma non modificato, un record.

ResetForm

La funzione ResetForm reimposta il contenuto di un modulo ai valori iniziali, prima che l'utente implementasse le modifiche. Se il modulo fosse in modalità FormMode.New, verrebbe reimpostato sulla modalità FormMode.Edit. Il comportamento OnReset del controllo Form viene anche eseguito.

Sintassi

SubmitForm( NomeModulo )

  • NomeModulo: obbligatorio. Controllo Form da inviare all'origine dati.

EditForm( NomeModulo )

  • NomeModulo: obbligatorio. Controllo Form per passare alla modalità FormMode.Edit.

NewForm( NomeModulo )

  • NomeModulo: obbligatorio. Controllo Form per passare alla modalità FormMode.New.

ResetForm( NomeModulo )

  • NomeModulo: obbligatorio. Controllo Form per reimpostare i valori iniziali. Passa anche il form dalla modalità FormMode.New alla modalità FormMode.Edit.

Esempi

Per esempi completi, vedere Understand data forms (Informazioni sui moduli di dati).

  1. Aggiungere un controllo Button, impostarne la proprietà Text per visualizzare Save e impostare la proprietà OnSelect con questa formula:

    SubmitForm( EditForm )

  2. Impostare la proprietà OnFailure di un controllo Form su blank e la proprietà OnSuccess con questa formula:

    Back()

  3. Assegnare il nome ErrorText al controllo di una casella di testo e impostarne la proprietà Text con questa formula:

    EditForm.Error

    Quando l'utente seleziona il pulsante Salva, le modifiche nel controllo Form vengono inviate all'origine dati sottostante.

    • Se l'invio riesce, le modifiche verranno salvate o, se il controllo Form è in modalità New, viene creato un record. ErrorText è blank, quindi viene visualizzata di nuovo la schermata precedente.
    • Se l'invio non riesce, ErrorText visualizza un messaggio di errore descrittivo e la schermata corrente rimane visibile in modo che l'utente possa risolvere il problema e riprovare.
  4. Aggiungere un controllo Button, impostarne la proprietà Text per visualizzare Cancel e impostarne la proprietà OnSelect con questa formula:

    ResetForm( EditForm ); Back()

    Quando l'utente seleziona il pulsante Cancel, i valori del controllo Form vengono reimpostati alle condizioni precedenti alla modifica da parte dell'utente, viene visualizzata la schermata precedente e il controllo Form viene riportato alla modalità Edit se fosse in modalità New.

  5. Aggiungere un controllo Button, impostarne la proprietà Text per visualizzare New e impostare la proprietà OnSelect con questa formula:

    NewForm( EditForm ); Navigate( EditScreen, None )

    Quando l'utente seleziona il pulsante New, il controllo Form passa in modalità New, i valori predefiniti per l'origine dati del controllo Form popolano tale controllo e viene visualizzata la schermata che contiene il controllo Form. Quando la funzione SubmitForm viene eseguita, viene creato, ma non aggiornato, un record.