Funkcije EditForm, NewForm, SubmitForm, ResetForm i ViewForm
Važi za: Canvas aplikacije
Pregledajte, izmenite ili kreirajte stavku, sačuvajte sadržaj i resetujte kontrole u okviru kontrole obrazac za uređivanje.
Pregled
Ove funkcije menjaju status kontrole obrazac za uređivanje. Kontrola obrasca može biti u jednom od ovih režima:
Režim | Opis |
---|---|
FormMode.Edit | Obrazac se popunjava postojećim zapisom i korisnik može da menja vrednosti polja. Kada završite, korisnik može da sačuva izmene zapisa. |
FormMode.New | Obrazac je popunjen podrazumevanim vrednostima i korisnik može da menja vrednosti polja. Kada završite, korisnik može da doda zapis u izvor podataka. |
FormMode.View | Obrazac se popunjava postojećim zapisom, ali korisnik ne može da menja vrednosti polja. |
Opis
Ove funkcije se često pozivaju iz OnSelect formule kontrole dugmeta ili slike tako da korisnik može da sačuva uređivanja, napusti uređivanje ili kreira zapis. Možete da koristite kontrole i ove funkcije zajedno da biste kreirali potpuno rešenje.
Ove funkcije ne vraćaju vrednost.
Ove funkcije možete koristiti samo u okviru formula ponašanja.
SubmitForm
Koristite funkciju SubmitForm u svojstvu OnSelect kontrole dugmeta da biste sačuvali sve promene u kontroli obrasca u izvoru podataka.
Pre prosleđivanja bilo kakvih promena, ova funkcija proverava da li postoje li problemi sa validacijom sa bilo kojim poljem koje je označeno kao potrebno ili koje ima jedno ili više ograničenja za vrednost. Ovo ponašanje se poklapa sa ponašanjem funkcije Validate.
Obrazac za prosleđivanje takođe proverava važeće svojstvo obrasca, što je agregacija ... svih važećih svojstava kartica kontrola koje kontrola obrasca sadrži. Ako dođe do problema, podaci se ne prosleđuju, a svojstva Error i ErrorKind kontrole obrasca postavljena su u skladu s tim.
Ako validacija prođe, SubmitForm prosleđuje promenu u izvor podataka.
- Ako uspete, pokreće se ponašanje OnSuccess obrasca i čiste se svojstva Error and ErrorKind . Ako je obrazac bio u režimu FormMode.New, vraćen je u režim FormMode.Edit.
- Ako ne uspete, ponašanje obrasca " OnFailure" se pokreće, a svojstva "Greška" i " ErrorKind" su postavljena u skladu sa tim. Režim obrasca je nepromenjen.
EditForm
Funkcija EditForm menja režim kontrole obrasca u FormMode.Edit. U ovom režimu, sadržaj svojstva Item kontrole obrasca se koristi za popunjavanje obrasca. Ako se funkcija SubmitForm pokreće kada je obrazac u ovom režimu, zapis se menja, a ne kreira. FormMode.Edit je podrazumevana za kontrolu obrasca.
Belešku
Kada se obrazac nalazi u režim uređivanja stavka je bez vrednosti, kartica se ne proveravaju i vratiće podrazumevane vrednosti.
NewForm
Funkcija NewForm menja režim kontrole obrasca u FormMode.New. U ovom režimu, sadržaj svojstva Item kontrole obrasca se ignoriše, a podrazumevane vrednosti svojstva DataSource obrasca popunjavaju obrazac. Ako se funkcija SubmitForm pokreće kada je obrazac u ovom režimu, zapis se kreira, a ne menja.
ResetForm
Funkcija ResetForm ponovo postavlja sadržaj obrasca na njegovu početnu vrednost, pre nego što je korisnik izvršio bilo kakve promene. Ako je obrazac u režimu FormMode.New, obrazac je resetovan u režim FormMode.Edit. Ponašanje kontrole OnReset obrasca takođe se pokreće. Takođe možete resetovati pojedinačne kontrole pomoću funkcije Reset, ali samo unutar obrasca.
ViewForm
Funkcija ViewForm menja režim kontrole obrasca u FormMode.View. U ovom režimu, sadržaj svojstva Item kontrole obrasca se koristi za popunjavanje obrasca. Funkcije SubmitForm i ResetForm nemaju efekta kada su u ovom režimu.
Svojstvo DisplayMode
Trenutni režim se može očitati unutar svojstva Režim. Režim takođe određuje vrednost svojstva DisplayMode, koje mogu koristiti kartice podataka i kontrole u okviru kontrole obrasca. Često će svojstvo Režim prikaza kartice podataka biti postavljeno na Parent.DisplayMode (upućuje na obrazac), kao i svojstvo Režim prikaza kontrole (upućuje na karticu podataka):
Režim | DisplayMode | Opis |
---|---|---|
FormMode.Edit | DisplayMode.Edit | Kartice podataka i kontrole se mogu uređivati, spremne da prihvate promene u zapisu. |
FormMode.New | DisplayMode.Edit | Kartice podataka i kontrole se mogu uređivati, spremne da prihvate novi zapis. |
FormMode.View | DisplayMode.View | Kartice podataka i kontrole se ne mogu uređivati ili optimizovati za gledanje. |
Sintaksa
SubmitForm( FormName )
- FormName – Obavezno. Kontrolu obrasca koju treba proslediti u izvor podataka.
EditForm( FormName )
- FormName – Obavezno. Kontrola obrasca za prelazak na režim FormMode.Edit.
NewForm( FormName )
- FormName – Obavezno. Kontrola obrasca za prelazak na režim FormMode.New.
ResetForm( FormName )
- FormName – Obavezno. Kontrola obrasca za vraćanje na početne vrednosti. Takođe prebacuje obrazac iz režima FormMode.New u režim FormMode.Edit.
ViewForm( FormName )
- FormName – Obavezno. Kontrola obrasca za prelazak na režim FormMode.View.
Primeri
Pogledajte Razumevanje obrazaca podataka za potpune primere.
Dodajte kontrolu Dugme, podesite svojstvo Text da pokaže Sačuvaj, a zatim i postavite svojstvo OnSelect prema ovoj formuli:
SubmitForm( EditForm )
Podesite svojstvo OnFailure kontrole obrasca na prazno i njegovo svojstvo OnSuccess prema ovoj formuli:
Back()
Imenujte kontrolu Oznaka ErrorText i podesite njeno svojstvo Text prema ovoj formuli:
EditForm.Error
Kada korisnik izabere dugme Sačuvaj, sve promene u kontroli obrasca se prosleđuju u osnovni izvor podataka.
- Ako prijava uspe, sve promene se spremaju ili, ako je kontrola obrasca u režimu Novo, kreira se zapis. ErrorText je prazna, a prethodni ekran se ponovo pojavljuje.
- Ako prijava ne uspe, ErrorText prikazuje poruku o grešci prilagođenu korisničku, a trenutni ekran ostaje vidljiv kako bi korisnik mogao da ispravi problem i pokuša ponovo.
Dodajte kontrolu Dugme, podesite svojstvo Text da pokaže Otkaži, a zatim i postavite svojstvo OnSelect prema ovoj formuli:
ResetForm( EditForm ); Back()
Kada korisnik odabere dugme Otkaži, vrednosti u kontroli obrasca se vraćaju na ono što su bile pre nego što je korisnik počeo da ga uređuje, pojavljuje se prethodni ekran, a kontrola obrasca se vraća u režim Uredi ako je bila u režimu Novo.
Dodajte kontrolu Dugme, podesite svojstvo Text da pokaže Novo, a zatim i postavite svojstvo OnSelect prema ovoj formuli:
NewForm( EditForm ); Navigate( EditScreen, None )
Kada korisnik izabere dugme Novo, kontrola obrasca prelazi u režim Novo, podrazumevane vrednosti za izvor podataka kontrole obrasca popunjavaju tu kontrolu, a pojavljuje se ekran koji sadrži kontrolu obrasca. Kada je funkcija SubmitForm pokrenuta, zapis se kreira umesto da se ažurira.