Funktsioonid EditForm, NewForm, SubmitForm, ResetForm ja ViewForm
Kehtib:
Lõuendirakendused
Üksuse vaatamine, redigeerimine või loomine, sisu salvestamine ja juhtelementide lähtestamine juhtelemendis Edit form (Redigeeri vormi).
Ülevaade
Need funktsioonid muudavad juhtelemendi Edit form olekut. Vormi juhtelement võib olla ühes järgmistest olekutest.
| Režiim | Kirjeldus |
|---|---|
| FormMode.Edit | Vorm on asustatud olemasoleva kirjega ja kasutaja saab väljade väärtusi muuta. Pärast lõpuleviimist saab kasutaja kirje muudatused salvestada. |
| FormMode.New | Vorm on asustatud vaikeväärtustega ja kasutaja saab väljade väärtusi muuta. Pärast lõpuleviimist saab kasutaja lisada kirje andmeallikale. |
| FormMode.View | Vorm on asustatud olemasoleva kirjega, kuid kasutaja ei saa väljade väärtusi muuta. |
Kirjeldus
Neid funktsioone käivitatakse sageli nupu või pildi juhtelemendi valemistOnSelect , et kasutaja saaks muudatusi salvestada, muudatustest loobuda või kirje luua. Täieliku lahenduse loomiseks saate kasutada juhtelemente ja funktsioone koos.
Need funktsioonid ei tagasta väärtusi.
Neid funktsioone saate kasutada ainult käitumise valemites.
SubmitForm
Juhtelemendi Form muudatuste salvestamiseks andmeallikasse kasutage funktsiooni SubmitForm nupu atribuudis OnSelect, et salvestada muudatused juhtelemendis Form andmeallikasse.
Enne muudatuste esitamist kontrollib see funktsioon valideerimise probleeme mis tahes väljaga, mis on märgitud nõutavana või millel on selle väärtuse jaoks üks või mitu piirangut. See käitumine sobib funktsiooni Validate omaga.
SubmitForm kontrollib ka vormi atribuuti Valid (Kehtiv ), mis on vormi juhtelemendis sisalduvate kaardi juhtelementide kõigi atribuutide Kehtivad atribuudid... . ... Kui ilmneb probleem, siis andmeid ei esitata ja juhtelemendi Form Error ja ErrorKind atribuudid määratakse vastavalt.
Kui valideerimine möödub, edastab SubmitForm muudatuse andmeallikasse.
- Kui see õnnestub, käivitatakse vormi käitumine OnSuccess ning atribuudid Tõrge ja TõrgeKind ... tühjendatakse. Kui vorm oli FormMode.New režiimis, viiakse see tagasi FormMode.Edit režiimile.
- Kui see ei õnnestu, käivitub vormi käitumine OnFailure ning atribuudid Error ja ErrorKind ... seatakse vastavalt. Vormi režiimi ei muudeta.
EditForm
Funktsioon EditForm muudab vormi juhtelemendi režiimiks FormMode. Edit. Selles režiimis kasutatakse juhtelemendi Vormi atribuuti Item vormi täitmiseks. Kui SubmitForm funktsioon käivitub, kui vorm on selles režiimis, muudetakse kirjet, mitte ei looda. FormMode.Edit on juhtelemendi Vorm vaikeväärtus.
Märkus.
Kui vorm on redigeerimisrežiim ja üksus on null, siis andmekaardi atribuute ei hinnata ja need tagastavad vaikeväärtused.
NewForm
Funktsioon NewForm muudab juhtelemendi Vorm režiimiks FormMode.New. Selles režiimis ignoreeritakse vormi juhtelemendi atribuudi Item sisu ja vormi atribuudi DataSource vaikeväärtused asustavad vormi. Kui SubmitForm funktsioon käivitub, kui vorm on selles režiimis, luuakse kirje, mitte ei muudeta.
ResetForm
Funktsioon ResetForm lähtestab vormi sisu algsetele väärtustele, enne kui kasutaja on muudatused teinud. Kui vorm on FormMode.New režiimis, lähtestatakse vorm FormMode.Edit režiimile. Ka OnReset käitumine käivitatakse vormi juhtelemendis. Üksikuid juhtelemente saab lähtestada ka funktsiooniga Reset, kuid ainult vormi seest.
ViewForm
Funktsioon ViewForm muudab vormi juhtelemendi režiimiks FormMode.View. Selles režiimis kasutatakse juhtelemendi Vormi atribuuti Item vormi täitmiseks. SubmitForm ja ResetForm funktsioonid ei mõjuta seda režiimi.
Atribuut DisplayMode
Praegust režiimi saab lugeda atribuudi Režiim kaudu. Režiim määratleb ka DisplayMode atribuudi väärtuse, mida saavad kasutada andmete kaardid ja juhtelemendid vormi juhtelemendis. Sageli saab andmekaardi atribuudi DisplayMode seada väärtusele Parent.DisplayMode (viitab vormile), nagu ka juhtelemendi atribuudi DisplayMode (viitab andmekaardile):
| Režiim | Kuvarežiim | Kirjeldus |
|---|---|---|
| FormMode.Edit | DisplayMode.Edit | Andmete kaardid ja juhtelemendid on muudetavad, valmis kirje muudatuste aktsepteerimiseks. |
| FormMode.New | DisplayMode.Edit | Andmete kaardid ja juhtelemendid on muudetavad, uue kirje aktsepteerimiseks. |
| FormMode.View | DisplayMode.View | Andmete kaarte ja juhtelemente ei saa redigeerida ja optimeerida vaatamiseks. |
Süntaks
SubmitForm( FormName )
- FormName – nõutav. Vormi juhtelement, mille soovite andmeallikas esitada.
EditForm( FormName )
- FormName – nõutav. Vormi juhtelement, et aktiveerida FormMode.Edit režiim.
NewForm( FormName )
- FormName – nõutav. Vormi juhtelement, et aktiveerida FormMode.New režiim.
ResetForm( FormName )
- FormName – nõutav. Vormi juhtelement, mis lähtestatakse algsetele väärtustele. Lülitab ka vormi režiimi FormMode.New režiimile FormMode.Edit.
ViewForm( FormName )
- FormName – nõutav. Vormi juhteelement, et aktiveerida FormMode.View režiim.
Näited
Vt jaotist Andmevormide mõistmine, et näha rohkem näiteid.
Lisage juhtelement Nupp, seadke selle atribuut Text kuvama Salvesta ja seadke selle atribuut OnSelect sellele valemile:
SubmitForm( EditForm )
Seadke vormi juhtelemendi atribuut OnFailure väärtusele tühi ja selle atribuut OnSuccess valemile:
Back()
Andke juhtelemendile Label nimi ErrorText ja seadke selle atribuut Text valemile:
EditForm.Error
Kui kasutaja valib nupu Salvesta, esitatakse vormi juhtelemendi muudatused aluseks olevale andmeallikale.
- Kui edastus õnnestub, salvestatakse kõik muudatused või kui vormi juhtelement on režiimis Uus, luuakse kirje. ErrorText on tühi ja eelmine ekraan kuvatakse uuesti.
- Kui edastus nurjub, ErrorText kuvab kasutajasõbraliku tõrketeate ja praegune ekraan jääb nähtavaks, et kasutaja saaks probleemi lahendada, ja proovige siis uuesti.
Lisage juhtelement nupp, seadke selle atribuut Text kuvama Tühista ja seadke selle atribuut OnSelect valemile:
ResetForm( EditForm ); Back()
Kui kasutaja valib nupu Tühista, siis vormi juhtelemendi väärtused lähtestatakse nii, nagu nad enne kasutaja redigeerimist olid, kuvatakse eelmine ekraan ja vormi juhtelement tagastatakse režiimi Redigeeri, kui see oli režiimis New.
Lisage juhtelement ja seadke selle atribuut Text kuvama Uus ja seadke selle atribuut OnSelect valemile:
NewForm( EditForm ); Navigate( EditScreen, None )
Kui kasutaja valib nupu Uus, lülitub vormi juhtelement režiimi Uus, juhtelemendi vormi andmeallika vaikeväärtused asustavad selle juhtelemendi ning kuvatakse vormi juhtelementi sisaldav ekraan. Kui SubmitForm funktsioon käitatakse, luuakse kirje selle värskendamise asemel.