EditForm, NewForm, SubmitForm, ResetFormi ViewForm funkcije

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

Pomoću funkcije SubmitForm u svojstvu OnSelect kontrole gumba spremite sve promjene u kontroli obrasca u izvor 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.

SubmitFormprovjerava i svojstvo Valjano obrasca, što je agregacija svih valjanih svojstava kontrola kartica 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 provjera valjanosti prođe, SubmitForm šalje promjenu u izvor 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 kontrole obrasca u FormMode.Edit. U ovom načinu rada, sadržaj svojstva Item kontrole Form koristi se za popunjavanje obrasca. Ako se SubmitForm funkcija pokrene kada je obrazac u tom načinu rada, zapis se mijenja, a ne stvara se. 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 obrasca 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 SubmitForm funkcija pokrene kada je obrazac u tom načinu rada, zapis se stvara, a ne mijenja se.

ResetForm

Funkcija ResetForm vraća sadržaj obrasca na početne vrijednosti prije nego što korisnik unesete 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 obrasca 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 tom 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

SubmitForm( FormName )

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

EditForm( FormName )

• 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( FormName )

• 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( FormName )

• Naziv obrasca – 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:

   SubmitFormNe, ne, ne, EditForm ne.

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

   Natrag()

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

   EditForm. Greška

   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.

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

   ResetForm(eu) broj ( 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.

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

   NewForm(eu) broj ( 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 SubmitForm funkcija pokrene, umjesto ažuriranja stvara se zapis.