Funkcijos EditForm, NewForm, SubmitForm, ResetForm ir ViewForm
Taikoma:
drobės programoms
Peržiūrėkite, redaguokite arba sukurkite elementą, įrašykite turinį ir iš naujo nustatykite valdiklius redagavimo formos valdiklyje.
Apžvalga
Šios funkcijos pakeičia redagavimo formos valdiklio būseną. Formos valdiklis gali būti vieno iš tolesnių režimų.
| Režimas | Aprašas |
|---|---|
| FormMode.Edit | Forma užpildoma esamu įrašu, o vartotojas gali modifikuoti laukų reikšmes. Baigęs vartotojas gali įrašyti įrašo pakeitimus. |
| FormMode.New | Forma užpildoma numatytosiomis reikšmėmis, o vartotojas laukų reikšmes gali pakeisti. Baigęs vartotojas gali įrašą įtraukti į duomenų šaltinį. |
| FormMode.View | Forma užpildoma esamu įrašu, tačiau vartotojas negali modifikuoti laukų reikšmių. |
Aprašas
Šios funkcijos dažnai iškviečiamos iš mygtuko arba vaizdo valdiklio formulės OnSelect , kad vartotojas galėtų įrašyti pakeitimus, atsisakyti redagavimo arba sukurti įrašą. Kartu naudodami valdiklius ir šias funkcijas, galite sukurti visą sprendimą.
Šios funkcijos nepateikia jokių reikšmių.
Šias funkcijas galite naudoti tik veikimo formulėse.
SubmitForm
Norėdami bet kokius formos valdiklio pakeitimus įrašyti į duomenų šaltinį, naudokite funkciją SubmitForm, esančią mygtuko valdiklio ypatybėje OnSelect.
Prieš pateikdama bet kokius pakeitimus, ši funkcija patikrina, ar jokiame lauke, kuris pažymėtas kaip būtinas arba kurio reikšmei taikomas vienas ar daugiau apribojimų, nėra tvirtinimo problemų. Toks veikimas atitinka funkcijos Validate veikimą.
"SubmitForm" taip pat tikrina formos ypatybę Galioja , kuri yra visų formos valdiklio kortelė valdiklių Leistinų ypatybių agregatas. Jei iškyla problema, duomenys nepateikiami ir atitinkamai nustatomos formos valdiklio ypatybės Error bei ErrorKind.
Jei tikrinimas sėkmingas, SubmitForm pakeitimą pateikia duomenų šaltinyje.
- Jei pasiseka, paleidžiamas formos veikimas OnSuccess , o ypatybės Error ir ErrorKind išvalomos. Jei formos režimas buvo FormMode.New, ji grąžinama į režimą FormMode.Edit.
- Jei nepavyksta, paleidžiamas formos veikimas OnFailure ir atitinkamai nustatomos ypatybės Error ir ErrorKind . Formos režimas nepakeičiamas.
EditForm
Funkcija EditForm formos valdiklio režimą pakeičia į FormMode.Edit. Šiuo režimu forma užpildoma naudojant formos valdiklio ypatybės Item turinys. Jei funkcija SubmitForm vykdoma, kai forma veikia šiuo režimu, įrašas pakeičiamas, o ne sukuriamas. FormMode.Edit yra numatytasis formos valdiklis.
Pastaba.
Kai forma yra redagavimo režimas, o elementas yra neapibrėžtas (Item) yra neapibrėžtas, duomenų kortelė ypatybės neįvertinamos ir pateikiamos numatytosios reikšmės.
NewForm
Funkcija NewForm formos valdiklio režimą pakeičia į FormMode.New. Naudojant šį režimą, formos valdiklio ypatybės Item turinio nepaisoma, o forma užpildoma numatytosiomis formos ypatybės DataSource reikšmėmis. Jei funkcija SubmitForm vykdoma, kai forma veikia šiuo režimu, įrašas sukuriamas, o ne pakeičiamas.
ResetForm
Funkcija ResetForm iš naujo nustato pradines formos turinio reikšmes, kokios buvo prieš vartotojui atliekant keitimus. Jei formos režimas yra FormMode.New, ji iš naujo nustatoma į režimą FormMode.Edit. Taip pat vykdomas formos valdiklio veikimo būdas OnReset. Atskirus valdiklius iš naujo nustatyti taip pat galite naudodami funkciją Reset, tačiau tik formoje.
ViewForm
Funkcija ViewForm formos valdiklio režimą pakeičia į FormMode.View. Šiuo režimu forma užpildoma naudojant formos valdiklio ypatybės Item turinys. Veikdamos šiuo režimu funkcijos SubmitForm ir ResetForm neturi jokio poveikio.
Ypatybė DisplayMode
Dabartinį režimą galima skaityti naudojant ypatybę Režimas. Režimas taip pat nustato ypatybės DisplayMode, kurią duomenų kortelės ir valdikliai gali naudoti formos valdiklyje, reikšmę. Dažnai duomenų kortelės ypatybė DisplayMode bus nustatyta kaip Parent.DisplayMode (nurodant į formą); taip pat bus nustatyta ir valdiklio ypatybė DisplayMode (nurodant į duomenų kortelę):
| Režimas | DisplayMode | Aprašas |
|---|---|---|
| FormMode.Edit | DisplayMode.Edit | Duomenų kortelės ir valdikliai gali būti redaguojami, pasirengę priimti įrašo pakeitimus. |
| FormMode.New | DisplayMode.Edit | Duomenų kortelės ir valdikliai gali būti redaguojami, pasirengę priimti naują įrašą. |
| FormMode.View | DisplayMode.View | Duomenų kortelės ir valdikliai negali būti redaguojami ir yra optimizuoti peržiūrai. |
Sintaksė
SubmitForm( FormName )
- FormName - būtina. Formos valdiklis, kurį reikia pateikti duomenų šaltinyje.
EditForm( FormName )
- FormName - būtina. Formos valdiklis, kurį reikia perjungti į režimą FormMode.Edit.
NewForm( FormName )
- FormName - būtina. Formos valdiklis, kurį reikia perjungti į režimą FormMode.New.
ResetForm( FormName )
- FormName - būtina. Formos valdiklis, kuriam reikia iš naujo nustatyti pradines reikšmes. Taip pat formą iš režimo FormMode.New perjungia į režimą FormMode.Edit.
ViewForm( FormName )
- FormName - būtina. Formos valdiklis, kurį reikia perjungti į režimą FormMode.View.
Pavyzdžiai
Norėdami peržiūrėti išsamius pavyzdžius, žr. Duomenų formų supratimas.
Įtraukite mygtuko valdiklį, jo ypatybę Tekstas nustatykite taip, kad būtų rodoma Įrašyti, o jo ypatybę OnSelect nustatykite kaip šią formulę:
SubmitForm( EditForm )
Nustatykite tuščią formos valdiklio ypatybę OnFailure, o jo ypatybę OnSuccess nustatykite kaip šią formulę:
Atgal()
Žymos valdiklį pavadinkite ShowText ir jo ypatybę Tekstas nustatykite kaip šią formulę:
EditForm.Error
Kai vartotojas pasirenka mygtuką Įrašyti, visi formos valdiklio pakeitimai pateikiami turimame duomenų šaltinyje.
- Jei pateikti pavyksta, visi pakeitimai įrašomi arba, jei formos valdiklis veikia režimu Naujas, sukuriamas įrašas. ErrorText yra tuščias ir vėl pasirodo ankstesnis ekranas.
- Jei pateikti nepavyksta, žymoje ErrorText rodomas vartotojui patogus klaidos pranešimas, o dabartinis ekranas lieka matomas, kad vartotojas galėtų ištaisyti problemą ir bandyti dar kartą.
Įtraukite mygtuko valdiklį, jo ypatybę Tekstas nustatykite taip, kad būtų rodoma Atšaukti, o jo ypatybę OnSelect nustatykite kaip šią formulę:
ResetForm( EditForm ); Atgal()
Kai vartotojas pasirenka mygtuką Atšaukti, iš naujo nustatomos tokios formos valdiklio reikšmės, kokios buvo prieš vartotojui pradėjus jį redaguoti, vėl rodomas ankstesnis ekranas ir, jei formos valdiklis veikė režimu New, jis grąžinamas į režimą Redaguoti.
Įtraukite mygtuko valdiklį, jo ypatybę Tekstas nustatykite taip, kad būtų rodoma Naujas, o jo ypatybę OnSelect nustatykite kaip šią formulę:
NewForm( EditForm ); Naršyti( EditScreen, Nėra )
Kai vartotojas pasirenka mygtuką Naujas, formos valdiklis perjungiamas į režimą Naujas, valdiklis užpildomas numatytosiomis formos valdiklio duomenų šaltinio reikšmėmis ir rodomas ekranas, kuriame yra formos valdiklis. Kai vykdoma funkcija SubmitForm, įrašas ne naujinamas, o sukuriamas.