Nata
Norint pasiekti šį puslapį, reikalingas leidimas. Galite pabandyti prisijungti arba pakeisti katalogus.
Norint pasiekti šį puslapį, reikalingas leidimas. Galite pabandyti pakeisti katalogus.
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
SubmitForm Naudokite mygtuko valdiklio ypatybės OnSelect funkciją, kad įrašytumėte formos valdiklio pakeitimus į duomenų šaltinį.
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ą.
SubmitFormtaip pat patikrina formos ypatybę Valid, kuri yra visų valdiklių Kortelė, kuriuose yra formos valdiklis, leistinų ypatybių agregavimas. Jei iškyla problema, duomenys nepateikiami ir atitinkamai nustatomos formos valdiklio ypatybės Error bei ErrorKind.
Jei tikrinimas atliekamas sėkmingai, SubmitForm pateikia keitimą į duomenų šaltinį.
- 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 pakeičia formos valdiklio režimą į FormMode.Edit. Šiuo režimu forma užpildoma naudojant formos valdiklio ypatybės Item turinys. SubmitForm Jei funkcija 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 pakeičia formos valdiklio režimą į FormMode.New. Naudojant šį režimą, formos valdiklio ypatybės Item turinio nepaisoma, o forma užpildoma numatytosiomis formos ypatybės DataSource reikšmėmis. SubmitForm Jei funkcija vykdoma, kai forma veikia šiuo režimu, sukuriamas, o ne pakeičiamas įrašas.
ResetForm
Prieš ResetForm vartotojui atliekant keitimus, funkcija iš naujo nustato formos turinio pradines reikšmes. 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 pakeičia formos valdiklio režimą į FormMode.View. Šiuo režimu forma užpildoma naudojant formos valdiklio ypatybės Item turinys. Veikiant SubmitForm šiuo režimu, funkcijos 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ę:
SubmitForm100 % 20 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. Klaida
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( 100 % EditForm 2 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( 100 % EditForm 2 Naršyti( Redaguoti ekraną, 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. SubmitForm Kai funkcija veikia, įrašas sukuriamas, o ne atnaujinamas.