Deli putem

Funkcije EditForm, NewForm, SubmitForm, ResetForm i ViewForm

  • Članak

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.

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.

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

  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.