Funkcije EditForm, NewForm, SubmitForm, ResetForm in ViewForm

Velja za: aplikacije Canvas

Prikažite, uredite ali ustvarite element, shranite vsebine in ponastavite kontrolnike v kontrolniku Edit form.

Pregled

Te funkcije spremenijo stanje kontrolnika Edit form. Kontrolnik obrazca je lahko v enem od teh načinov:

Način	Opis
FormMode.Edit	Obrazec je izpolnjen z obstoječim zapisom in uporabnik lahko spremeni vrednosti polj. Ko je končano, lahko uporabnik shrani spremembe v zapisu.
FormMode.New	Obrazec je izpolnjen s privzetimi vrednostmi in uporabnik lahko spreminja vrednosti polj. Ko je končano, lahko uporabnik doda zapis viru podatkov.
FormMode.View	Obrazec je izpolnjen z obstoječim zapisom, toda uporabnik ne more spremeniti vrednosti polj.

Opis

Te funkcije se pogosto prikličejo iz OnSelect formule Gumba ali Slike nadzor, tako da lahko uporabnik shrani urejanja, opusti urejanja ali ustvari zapis. Skupaj lahko uporabite kontrolnike in te funkcije, da ustvarite celovito rešitev.

Te funkcije so brez vrnjenih vrednosti.

Funkciji lahko uporabljate samo v formulah za delovanje.

SubmitForm

Uporabite funkcijo SubmitForm v lastnosti OnSelect kontrolnika »Button«, da shranite morebitne spremembe v kontrolniku obrazca v vir podatkov.

Preden pošljete kakršne koli spremembe ta funkcija preveri za težave s preverjanjem veljavnosti s katerim koli poljem, ki je označeno kot obvezno ali ki ima eno ali več omejitev za svojo vrednost. To vedenje se ujema z vedenjem funkcije Validate.

SubmitForm preveri tudi Valid lastnost obrazca, ki je skupek vseh Valid lastnosti kontrolnikov Card , ki jih vsebuje kontrolnik obrazca. Če pride do težave, se podatki ne pošljejo in lastnosti Napaka in ErrorKind kontrolnika obrazca sta ustrezno nastavljeni.

Če je preverjanje veljavnosti opravljeno, SubmitForm pošlje spremembo v vir podatkov.

• Če je uspešen, teče vedenje obrazca OnSuccess in Error in ErrorKind lastnosti so izbrisane. Če je bil obrazec v načinu FormMode.New, je vrnjen v način FormMode.Edit.
• Če ni uspešen, se zažene vedenje obrazca OnFailure in Error in ErrorKind lastnosti so ustrezno nastavljene. Način obrazca je nespremenjen.

EditForm

Funkcija EditForm spremeni način kontrolnika obrazca na FormMode.Edit. V tem načinu se vsebine lastnosti Item kontrolnika obrazca uporabijo za izpolnitev obrazca. Če se izvede funkcija SubmitForm, ko je obrazec v tem načinu, je zapis spremenjen, ne ustvarjen. FormMode.Edit je privzeto za kontrolnik obrazca.

opomba,

Ko je obrazec v način urejanja in je element nič, lastnosti podatkovne kartice niso ovrednotene in bodo vrnile privzete vrednosti.

NewForm

Funkcija NewForm spremeni način kontrolnika obrazca na FormMode.New. V tem načinu se vsebine lastnosti Item kontrolnika obrazca prezrejo in privzete vrednosti lastnosti DataSource obrazca izpolnijo obrazec. Če se izvede funkcija SubmitForm, ko je obrazec v tem načinu, je zapis ustvarjen, ne spremenjen.

ResetForm

Funkcija ResetForm ponastavi vsebine obrazca na njihove prvotne vrednosti, preden je uporabnik izvedel kakršne koli spremembe. Če je obrazec v načinu FormMode.New, je obrazec ponastavljen na način FormMode.Edit. Izvede se tudi vedenje OnReset kontrolnika obrazca. Ponastavite lahko tudi posamezne kontrolnike s funkcijo Reset, toda samo iz obrazca.

ViewForm

Funkcija ViewForm spremeni način kontrolnika obrazca na FormMode.View. V tem načinu se vsebine lastnosti Item kontrolnika obrazca uporabijo za izpolnitev obrazca. Funkciji SubmitForm in ResetForm nimata učinka v tem načinu.

Lastnost DisplayMode

Trenutni način je mogoče prebrati prek lastnosti Mode. Način določa tudi vrednost lastnosti DisplayMode, ki jo lahko uporabijo podatkovne kartice in kontrolniki v kontrolniku obrazca. Pogosto bo lastnost DisplayMode podatkovne kartice nastavljena na Parent.DisplayMode (referenciranje obrazca) skupaj z lastnostjo DisplayMode (referenciranje podatkovne kartice):

Način	DisplayMode	Opis
FormMode.Edit	DisplayMode.Edit	Podatkovne kartice in kontrolnike lahko urejate ter so pripravljeni sprejeti spremembe v zapisu.
FormMode.New	DisplayMode.Edit	Podatkovne kartice in kontrolnike lahko urejate ter so pripravljeni sprejeti nov zapis.
FormMode.View	DisplayMode.View	Podatkovnih kartic in kontrolnikov ni mogoče urejati in so optimizirani za ogled.

Sintaksa

SubmitForm( FormName )

• FormName – obvezno. Nadzor obrazca za pošiljanje v vir podatkov.

EditForm( FormName )

• FormName – obvezno. Nadzor obrazca za preklop v način FormMode.Edit.

NewForm( FormName )

• FormName – obvezno. Nadzor obrazca za preklop v način FormMode.New.

ResetForm( FormName )

• FormName – obvezno. Kontrolnik obrazca za ponastavitev na prvotne vrednosti. Tudi preklopi obrazec iz načina FormMode.New v način FormMode.Edit.

ViewForm( FormName )

• FormName – obvezno. Nadzor obrazca za preklop v način FormMode.View.

Primeri

Glejte Razumevanje podatkovnih obrazcev za celovite primere.

1. Dodajte kontrolnik »Button«, nastavite njegovo lastnost Besedilo, da prikazuje Shrani, in nastavite njegovo lastnost OnSelect na to formulo:

   SubmitForm( EditForm )

2. Nastavite lastnost OnFailure kontrolnika obrazca na prazno in lastnost OnSuccess na to formulo:

   Back()

3. Poimenujte kontrolnik LabelErrorText in nastavite njegovo lastnost Besedilo na to formulo:

   EditForm.Error

   Ko uporabnik izbere gumb Shrani, se vse spremembe v kontrolniku obrazca pošljejo v temeljni vir podatkov.

   • Če je pošiljanje uspešno, se vse spremembe shranijo ali, če je kontrolnik obrazca v načinu Novo, je ustvarjen zapis. ErrorText je prazno in prikaže se prejšnji zaslon.
   • Če pošiljanje ni uspešno, ErrorText prikaže uporabniku prijazno sporočilo o napaki in trenutni zaslon ostane viden, da lahko uporabnik popravi težavo in poskusi znova.

4. Dodajte kontrolnik »Button«, nastavite njegovo lastnost Besedilo, da prikazuje Prekliči, in nastavite njegovo lastnost OnSelect na to formulo:

   ResetForm( EditForm ); Back()

   Ko uporabnik izbere gumb Prekliči, se vrednosti v kontrolniku obrazca ponastavijo na tiste pred uporabnikovim urejanjem, znova se prikaže prejšnji zaslon in kontrolnik obrazca je vrnjen v način Uredi, če je bil v načinu Novo.

5. Dodajte kontrolnik »Button«, nastavite njegovo lastnost Besedilo, da prikazuje Novo, in nastavite njegovo lastnost OnSelect na to formulo:

   NewForm( EditForm ); Navigate( EditScreen, None )

   Ko uporabnik izbere gumb Novo, kontrolnik obrazca preklopi na način Novo, privzete vrednosti za vir podatkov kontrolnika obrazca izpolnijo ta kontrolnik in prikaže se zaslon, ki vsebuje kontrolnik obrazec. Ko se izvede funkcija SubmitForm, je zapis ustvarjen, ne posodobljen.