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 kartica , 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, se zažene 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 privzeta vrednost za kontrolnik Form.
opomba,
Ko je obrazec v način urejanja in je element ničelna, lastnosti podatkov kartica 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
Predloži obrazec( Ime obrazca )
- Ime obrazca - obvezno. Nadzor obrazca za pošiljanje v vir podatkov.
Urejanje obrazca( Ime obrazca )
- Ime obrazca - obvezno. Nadzor obrazca za preklop v način FormMode.Edit.
Nov obrazec( Ime obrazca )
- Ime obrazca - obvezno. Nadzor obrazca za preklop v način FormMode.New.
Ponastavi obrazec( Ime obrazca )
- Ime obrazca - obvezno. Kontrolnik obrazca za ponastavitev na prvotne vrednosti. Tudi preklopi obrazec iz načina FormMode.New v način FormMode.Edit.
ViewForm( FormName )
- Ime obrazca - obvezno. Nadzor obrazca za preklop v način FormMode.View.
Primeri
Glejte Razumevanje podatkovnih obrazcev za celovite primere.
Dodajte kontrolnik »Button«, nastavite njegovo lastnost Besedilo, da prikazuje Shrani, in nastavite njegovo lastnost OnSelect na to formulo:
Predloži obrazec ( Uredi obrazec )
Nastavite lastnost OnFailure kontrolnika obrazca na prazno in lastnost OnSuccess na to formulo:
nazaj()
Poimenujte kontrolnik Label ErrorText 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 prazen in prejšnji zaslon se ponovno prikaže.
- Č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.
Dodajte kontrolnik »Button«, nastavite njegovo lastnost Besedilo, da prikazuje Prekliči, in nastavite njegovo lastnost OnSelect na to formulo:
PonastaviObrazec( UrediObrazec); nazaj()
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.
Dodajte kontrolnik »Button«, nastavite njegovo lastnost Besedilo, da prikazuje Novo, in nastavite njegovo lastnost OnSelect na to formulo:
NewForm( UrediForm); Krmarjenje (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.