Funkcije EditForm, NewForm, SubmitForm, ResetForm i ViewForm
Primjenjuje se na sljedeće:
Aplikacije radnog područja
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:
| Način | Opis |
|---|---|
| FormMode.Uredi | Obrazac se puni postojećim zapisom i korisnik može mijenjati vrijednosti tih polja. Nakon dovršetka, korisnik može spremiti promjene u zapis. |
| Način obrasca.Novo | Obrazac se popunjava zadanim vrijednostima i korisnik može mijenjati vrijednosti polja. Nakon dovršetka, korisnik može dodati zapis u izvor podataka. |
| FormMode.View | Obrazac se puni postojećim zapisom, ali korisnik ne može mijenjati vrijednosti tih polja. |
Opis
Te se funkcije često pozivaju iz formule OnSelect kontrole gumba ... ili slike kako bi korisnik mogao spremiti izmjene, napustiti izmjene ili stvoriti 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 Valid obrasca, koje je agregacija svih svojstava Valid kontrola kartica koje sadrži kontrola Obrazac. 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 je uspješno, pokreće se ponašanje obrasca OnSuccess , 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 obrasca OnFailure , a svojstva Error i ErrorKind postavljaju se u skladu s tim. 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 zadana je postavka za kontrolu Obrazac.
Napomena
Kada je obrazac u načinu uređivanja, a stavka je null, svojstva kartica podataka ne procjenjuju se i vratit će zadane vrijednosti.
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):
| Način | DisplayMode | Opis |
|---|---|---|
| FormMode.Uredi | DisplayMode.Uredi | Podatkovne kartice i kontrole mogu se uređivati i spremne su prihvatiti izmjene zapisa. |
| Način obrasca.Novo | DisplayMode.Uredi | Podatkovne kartice i kontrole mogu se uređivati i spremne su prihvatiti novi zapis. |
| FormMode.View | DisplayMode.View | Podatkovne kartice i kontrole nije moguće uređivati i nisu optimizirane za gledanje. |
Sintaksa
PošaljiObrazac( NazivObrasca)
- Naziv obrasca – obavezno. Kontrola obrasca koja se šalje izvoru podataka.
Obrazac za uređivanje( Naziv obrasca)
- Naziv obrasca – obavezno. Kontrola obrasca za prelazak na način rada FormMode.Edit.
NewForm( FormName )
- Naziv obrasca – obavezno. Kontrola obrasca za prelazak na način rada FormMode.New.
ResetForm( ObrazacNaziv )
- Naziv obrasca – 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( NazivObrasca)
- Naziv obrasca – obavezno. Kontrola obrasca za prelazak na način rada FormMode.View.
Primjeri
Za cjelovite primjere pogledajte Razumijevanje obrazaca podataka.
Dodajte kontrolu Button, postavite njezino svojstvo Text tako da pokaže Spremi i postavite njezino svojstvo OnSelect na ovu formulu:
SubmitForm( EditForm )
Postavite svojstvo OnFailure kontrole Form na prazno, a njezino svojstvo OnSuccess na ovu formulu:
Natrag()
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 prazan 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.
Dodajte kontrolu Button, postavite njezino svojstvo Text tako da pokaže Odustani i postavite njezino svojstvo OnSelect na ovu formulu:
ResetForm( EditForm ); Natrag()
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.
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.