Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Si applica a:
App Canvas
Visualizzare, modificare o creare un elemento, salvare il contenuto e reimpostare i controlli in un controllo Edit form.
Panoramica
Queste funzioni modificano lo stato del controllo Edit form. Il controllo form può trovarsi in una delle modalità seguenti:
| Modalità | Descrizione |
|---|---|
| ModalitàForma.Modifica | Il modulo viene popolato con un record esistente e l'utente può modificare i valori dei campi. Al termine dell'operazione, l'utente può salvare le modifiche al record. |
| ModalitàForma.Nuovo | Il modulo viene popolato con valori predefiniti e l'utente può modificare i valori dei campi. Al termine dell'operazione, l'utente può aggiungere il record all'origine dati. |
| ModalitàForma.Visualizzazione | Il modulo viene popolato con un record esistente ma l'utente non può modificare i valori dei campi. |
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.
È possibile usare queste funzioni solo in formule di comportamento.
SubmitForm
Utilizzare la SubmitForm funzione nella proprietà OnSelect di un controllo Button per salvare le modifiche apportate a 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 inoltre la proprietà Valid del form, ovvero un'aggregazione di tutte le proprietà Valide dei controlli Scheda contenuti nel controllo Modulo. 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 viene superata, SubmitForm invia la modifica all'origine dati.
- Se ha esito positivo, viene eseguito il comportamento della proprietà OnSuccess del modulo 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 del modulo e le proprietà Error e ErrorKind vengono impostate di conseguenza. La modalità del modulo rimane invariata.
EditForm
La EditForm funzione 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 SubmitForm funzione viene eseguita quando la maschera è in questa modalità, viene modificato un record, non creato. FormMode.Edit è l'impostazione predefinita per il controllo Form.
Nota
Quando il modulo è in modalità di modifica e Item è null, le proprietà della scheda dati non vengono valutate e restituiranno i valori predefiniti.
NewForm
La NewForm funzione 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 del modulo compilano il modulo. Se la SubmitForm funzione viene eseguita quando il form è in questa modalità, viene creato un record, non modificato.
ResetForm
La ResetForm funzione reimposta il contenuto di un modulo sui relativi valori iniziali, prima che l'utente apporta le modifiche. Se il modulo fosse in modalità FormMode.New, verrebbe reimpostato sulla modalità FormMode.Edit. Anche il comportamento OnReset del controllo form viene eseguito. È anche possibile reimpostare i singoli controlli con la funzione Reset ma solo all'interno del modulo.
ViewForm
La ViewForm funzione modifica la modalità del controllo Form in FormMode.View. In questa modalità, il contenuto della proprietà Item del controllo form viene usato per compilare il modulo. Le SubmitForm funzioni e ResetForm non hanno alcun effetto quando in questa modalità.
Proprietà DisplayMode
La modalità corrente può essere letta attraverso la proprietà Mode. La modalità determina anche il valore della proprietà DisplayMode che può essere usata da schede di dati e controlli nel controllo form. Spesso, la proprietà DisplayMode della scheda dati verrà impostata su Parent.DisplayMode (che fa riferimento al modulo) così come la proprietà DisplayMode del controllo (che fa riferimento alla scheda dati):
| Modalità | DisplayMode | Descrizione |
|---|---|---|
| ModalitàForma.Modifica | DisplayMode.Edit | Schede di dati e controlli sono modificabili, pronti per accettare le modifiche apportate a un record. |
| ModalitàForma.Nuovo | DisplayMode.Edit | Schede di dati e controlli sono modificabili, pronti per accettare un nuovo record. |
| ModalitàForma.Visualizzazione | DisplayMode.View | Schede di dati e controlli non sono modificabili ma sono ottimizzati per la visualizzazione. |
Sintassi
SubmitForm( FormName )
- FormName - Obbligatorio. Controllo Form da inviare all'origine dati.
EditForm( FormName )
- FormName - Obbligatorio. Controllo Form per passare alla modalità FormMode.Edit.
NewForm( FormName )
- FormName - Obbligatorio. Controllo Form per passare alla modalità FormMode.New.
ResetForm( FormName )
- FormName - Obbligatorio. Controllo Form per reimpostare i valori iniziali. Inoltre passa il modulo dalla modalità FormMode.New alla modalità FormMode.Edit.
ViewForm( FormName )
- FormName - Obbligatorio. Controllo Form per passare alla modalità FormMode.View.
Esempi
Per esempi completi, vedere Informazioni sui moduli dati.
Aggiungere un controllo Button, impostare la relativa proprietà Text per visualizzare Save e impostare la proprietà OnSelect su questa formula:
SubmitForm( EditForm )
Impostare la proprietà OnFailure di un controllo form su blank e la relativa proprietà OnSuccess su questa formula:
Indietro()
Assegnare il nome ErrorText a un controllo Label e impostare la relativa proprietà Text su questa formula:
EditForm. Errore
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 è vuoto e viene nuovamente visualizzata 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.
Aggiungere un controllo Button, impostare la relativa proprietà Text per visualizzare Cancel e impostare la relativa proprietà OnSelect su 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à Nuovo.
Aggiungere un controllo Button, impostare la relativa proprietà Text per visualizzare Nuovo e impostare la relativa proprietà OnSelect su 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 SubmitForm funzione viene eseguita, viene creato un record anziché aggiornato.