Funkcije EditForm, NewForm, SubmitForm, ResetForm i ViewForm

Odnosi se na: 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 dugmetaili 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ćihsvojstava kontrola kartice koje sadrži kontrola obrasca. 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 , a svojstva Error and ErrorKind se čiste. 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 je obrazac u fascikli "režim uređivanja stavka je bez vrednosti", svojstva kartice sa podacima 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.

1. Dodajte kontrolu Dugme, podesite svojstvo Text da pokaže Sačuvaj, a zatim i postavite svojstvo OnSelect prema ovoj formuli:

   SubmitForm( EditForm )

2. Podesite svojstvo OnFailure kontrole obrasca na prazno i njegovo svojstvo OnSuccess prema ovoj formuli:

   Back()

3. Imenujte kontrolu OznakaErrorText 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.

4. 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.

5. 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.