Funkcije EditForm, NewForm, SubmitForm, ResetForm i ViewForm

Odnosi se na: Aplikacije od gotovih gradivnih elemenata

Pregledajte, uredite ili stvorite stavku, spremite sadržaj i resetirajte kontrole u kontroli Edit form.

Pregled

Ove funkcije mijenjaju stanje kontrole Edit form. Kontrola obrasca može biti u jednom od ovih načina:

Opis

Te se funkcije često pozivaju iz formule OnSelect gumba ... ili kontrole slike kako bi korisnik mogao spremati uređivanja, napuštati uređivanja ili stvarati zapis. Možete koristiti kontrole i ove funkcije zajedno kako biste stvorili jedno potpuno rješenje.

Ove funkcije ne vraćaju vrijednosti.

Ove funkcije možete koristiti samo u formulama ponašanja.

SubmitForm

Upotrijebite funkciju SubmitForm u svojstvu OnSelect kontrole Button kako biste spremili sve promjene u kontroli Form tog izvora podataka.

Prije podnošenja bilo kakvih promjena, ova funkcija provjerava postoje li problemi s validacijom bilo kog polja koje je označeno kao zahtijevano ili koje ima jedno ili više ograničenja vrijednosti. Ovo ponašanje odgovara ponašanju funkcije Validate.

SubmitForm također provjerava svojstvo obrasca Valjano , koje je agregacija svih važećihsvojstava kontrola kartice koje kontrola obrasca sadrži. Ako dođe do problema, podatci se ne šalju, a svojstva Error i ErrorKind kontrole Form postavljaju se u skladu s tim.

Ako validacija prođe, SubmitForm šalje izmjenu izvoru podataka.

• Ako uspije , pokreće se ponašanje OnSuccess obrasca, a svojstva Error i ErrorKind ... se brišu. Ako je obrazac bio u načinu rada FormMode.New, vraća se u način rada FormMode.Edit.
• Ako ne uspije, pokreće se ponašanje OnFailure obrasca , a u skladu s tim postavljaju se svojstva Error i ErrorKind . Način rada obrasca je nepromijenjen.

EditForm

Funkcija EditForm mijenja način rada kontrole Form u FormMode.Edit. U ovom načinu rada, sadržaj svojstva Item kontrole Form koristi se za popunjavanje obrasca. Ako se funkcija SubmitForm pokreće kada je obrazac u ovom načinu rada, zapis se mijenja, a ne stvara. FormMode.Edit je zadana vrijednost kontrole Form.

NewForm

Funkcija NewForm mijenja način rada kontrole Form u FormMode.New. U ovom načinu rada, sadržaj svojstva Item kontrole Form zanemaruje se, a zadane vrijednosti svojstva DataSource kontrole Form popunjavaju obrazac. Ako se funkcija SubmitForm pokreće kada je obrazac u ovom načinu rada, zapis se stvara, a ne mijenja.

ResetForm

Funkcija ResetForm resetira sadržaj obrasca na njegove početne vrijednosti prije nego što korisnik izvrši bilo kakve promjene. Ako je obrazac u načinu rada FormMode.New, obrazac se resetira u način rada FormMode.Edit. Pokreće se i ponašanje OnReset kontrole obrasca. Također, možete resetirati pojedinačne kontrole funkcijom Reset, ali samo unutar obrasca.

ViewForm

Funkcija ViewForm mijenja način rada kontrole Form u FormMode.View. U ovom načinu rada, sadržaj svojstva Item kontrole Form koristi se za popunjavanje obrasca. Funkcije SubmitForm i ResetForm nemaju učinka u ovom načinu rada.

Svojstvo DisplayMode

Trenutačni se način može očitati putem svojstva Mode. Način također određuje vrijednost svojstva DisplayMode koje mogu koristiti podatkovne kartice i kontrole unutar kontrole obrasca. Često se svojstvo DisplayMode podatkovne kartice postavlja na Parent.DisplayMode (referenciranje obrasca), kao i svojstvo DisplayMode te kontrole (referenciranje podatkovne kartice):

Sintaksa

SubmitForm( FormName )

• FormName – obavezno. Kontrola obrasca koja se šalje izvoru podataka.

EditForm( FormName )

• FormName – obavezno. Kontrola obrasca za prelazak na način rada FormMode.Edit.

NewForm( FormName )

• FormName – obavezno. Kontrola obrasca za prelazak na način rada FormMode.New.

ResetForm( FormName )

• FormName – obavezno. Kontrola obrasca za resetiranje na početne vrijednosti. Također, prebacuje obrazac iz načina rada FormMode.New u način rada FormMode.Edit.

ViewForm( FormName )

• FormName – obavezno. Kontrola obrasca za prelazak na način rada FormMode.View.

Primjeri

Za cjelovite primjere pogledajte Razumijevanje obrazaca podataka.

1. Dodajte kontrolu Button, postavite njezino svojstvo Text tako da pokaže Spremi i postavite njezino svojstvo OnSelect na ovu formulu:

   SubmitForm( EditForm )

2. Postavite svojstvo OnFailure kontrole Form na prazno, a njezino svojstvo OnSuccess na ovu formulu:

   Back()

3. Kontrolu Label nazovite ErrorText i postavite njezino svojstvo Text na ovu formulu:

   EditForm.Error

   Kad korisnik odabere gumb Spremi, sve promjene u kontroli Form prosljeđuju se osnovnom izvoru podataka.

   • Ako prosljeđivanje uspije, sve promjene se spremaju ili, ako je kontrola Form u načinu rada New, stvara se zapis. ErrorText je prazno i ponovno se pojavljuje prethodni zaslon.
   • Ako prosljeđivanje ne uspije, ErrorText prikazuje korisničku poruku o pogrešci, a trenutačni zaslon ostaje vidljiv kako bi korisnik mogao ispraviti problem i pokušati ponovo.

4. Dodajte kontrolu Button, postavite njezino svojstvo Text tako da pokaže Odustani i postavite njezino svojstvo OnSelect na ovu formulu:

   ResetForm( EditForm ); Back()

   Kad korisnik odabere gumb Odustani, vrijednosti u kontroli Form vraćaju se na one koje su važile prije nego što je korisnik počeo uređivati, ponovno se pojavljuje prethodni zaslon, a kontrola Form vraća se u način rada Edit ako je bio u načinu rada New.

5. Dodajte kontrolu Button, postavite njezino svojstvo Text tako da pokaže Novo i postavite njezino svojstvo OnSelect na ovu formulu:

   NewForm( EditForm ); Navigate( EditScreen, None )

   Kad korisnik odabere gumb Novo, kontrola Form prelazi na način rada New, zadane vrijednosti za izvor podataka kontrole Form popune tu kontrolu, a pojavljuje se zaslon koji sadrži kontrolu Form. Kada se izvršava funkcija SubmitForm, zapis se ne ažurira nego stvara.