Funkcijas EditForm, NewForm, SubmitForm, ResetForm un ViewForm
Attiecas uz:
Audekla programmām
Skatiet, rediģējiet vai izveidojiet elementu, saglabājiet saturu un atiestatiet vadīklas Edit form vadīklā.
Pārskats
Šīs funkcijas maina vadīklas Rediģēt veidlapu statusu. Veidlapas vadīkla var būt vienā no šiem režīmiem:
| Režīms | Apraksts |
|---|---|
| FormMode.Edit | Veidlapa tiek aizpildīta ar esošu ierakstu, un lietotājs var modificēt lauku vērtības. Pēc pabeigšanas lietotājs var saglabāt ierakstā veiktās izmaiņas. |
| FormMode.Jauns | Veidlapa tiek aizpildīta ar noklusējuma vērtībām un lietotājs var modificēt lauku vērtības. Pēc pabeigšanas lietotājs var pievienot ierakstu datu avotam. |
| FormMode.View | Veidlapa tiek aizpildīta ar esošu ierakstu, taču lietotājs nevar modificēt lauku vērtības. |
Apraksts
Šīs funkcijas bieži tiek izsauktas no pogas vai attēla vadīklas formulas OnSelect ... , lai lietotājs varētu saglabāt rediģējumus, atteikties no labojumiem vai izveidot ierakstu. Varat izmantot vadīklas un šīs funkcijas kopā, lai izveidotu pilnīgu risinājumu.
Šīs funkcijas neatgriež vērtības.
Varat šīs funkcijas izmantot vienīgi uzvedības formulās.
SubmitForm
Izmantojiet funkciju SubmitForm Pogas vadīklas rekvizītā OnSelect, lai Veidlapas vadīklā saglabātu jebkādas datu avota izmaiņas.
Pirms izmaiņu iesniegšanas šī funkcija pārbauda, vai nav validācijas problēmu attiecībā uz jebkādu lauku, kas atzīmēts kā nepieciešams vai kura vērtībai ir viens vai vairāki ierobežojumi. Šāda uzvedība atbilst funkcijas Validate uzvedībai.
SubmitForm pārbauda arī veidlapas rekvizītu Derīgs , kas ir visu veidlapas vadīklā ietverto karte vadīklu Derīgo rekvizītu apkopojums. Ja rodas problēma, dati netiek iesniegti un Veidlapas vadīklas rekvizīti Error un ErrorKind tiek atbilstoši iestatīti.
Ja validācija izdodas, SubmitForm iesniedz datu avota izmaiņas.
- Ja tas izdodas, tiek palaista veidlapas darbība OnSuccess, un rekvizīti Error un ErrorKind tiek notīrīti. Ja veidlapa bija režīmā FormMode.New, tā tiek atgriezta režīmā FormMode.Edit.
- Ja tas neizdodas, tiek palaista veidlapas darbība OnFailure , un attiecīgi tiek iestatīti rekvizīti Error un ErrorKind . Veidlapas režīms netiek mainīts.
EditForm
Funkcija EditForm maina Veidlapas vadīklas režīmu uz FormMode.Edit. Šajā režīmā veidlapas aizpildīšanai izmanto Veidlapas vadīklas rekvizīta Elements saturu. Ja funkciju SubmitForm palaiž, kad veidlapa ir šajā režīmā, ieraksts tiek mainīts, nevis izveidots. FormMode.Edit ir veidlapas vadīklas noklusējums.
Piezīmes
Ja veidlapa ir rediģēšanas režīms un vienums ir Null, dati karte rekvizīti netiek novērtēti un atgriež noklusējuma vērtības.
NewForm
Funkcija NewForm maina Veidlapas vadīklas režīmu uz FormMode.New. Šajā režīmā Veidlapas vadīklas rekvizīta Elements saturs tiek ignorēts un Veidlapas rekvizīta DataSource noklusējuma vērtības aizpilda veidlapu. Ja funkciju SubmitForm palaiž, kad veidlapa ir šajā režīmā, ieraksts tiek izveidots, nevis mainīts.
ResetForm
Funkcija ResetForm atiestata veidlapas saturu uz tā sākotnējām vērtībām, pirms lietotājs ir veicis kādas izmaiņas. Ja veidlapa ir režīmā FormMode.New, tā tiek atiestatīta uz režīmu FormMode.Edit. Tiek izpildīta arī veidlapas vadīklas uzvedība OnReset. Varat arī atiestatīt atsevišķas vadīklas, izmantojot funkciju Reset, taču tikai no veidlapas.
ViewForm
Funkcija ViewForm maina Veidlapas vadīklas režīmu uz FormMode.View. Šajā režīmā veidlapas aizpildīšanai izmanto Veidlapas vadīklas rekvizīta Elements saturu. Atrodoties šajā režīmā, funkcijām SubmitForm un ResetForm nav nekādas ietekmes.
DisplayMode rekvizīts
Pašreizējo režīmu var lasīt, izmantojot rekvizītu Režīms. Režīms arī nosaka rekvizīta DisplayMode vērtību, kuru datu kartītes un vadīklas var izmantot veidlapas vadīklā. Bieži vien datu kartītes rekvizītu DisplayMode iestatīs uz Parent.DisplayMode (atsaucoties uz veidlapu), tāpat kā iestatīs vadīklas rekvizītu DisplayMode (atsaucoties uz datu kartīti):
| Režīms | DisplayMode | Apraksts |
|---|---|---|
| FormMode.Edit | DisplayMode.Edit | Datu kartītes un vadīklas ir rediģējamas, sagatavotas ieraksta izmaiņu apstiprināšanai. |
| FormMode.Jauns | DisplayMode.Edit | Datu kartītes un vadīklas ir rediģējamas, sagatavotas jauna ieraksta apstiprināšanai. |
| FormMode.View | DisplayMode.View | Datu kartītes un vadīklas nav rediģējamas un optimizētas skatīšanai. |
Sintakse
SubmitForm( FormName )
- FormName - obligāts. Veidlapas vadīkla, kuru jāiesniedz datu avotam.
EditForm( FormName )
- FormName - obligāts. Veidlapas vadīkla, kuru pārslēgt uz režīmu FormMode.Edit.
NewForm( FormName )
- FormName - obligāts. Veidlapas vadīkla, kuru pārslēgt uz režīmu FormMode.New.
ResetForm( FormName )
- FormName - obligāts. Veidlapas vadīkla, kuru iestatīt uz sākotnējām vērtībām. Pārslēdz arī veidlapu no režīma FormMode.New uz režīmu FormMode.Edit.
ViewForm( FormName )
- FormName - obligāts. Veidlapas vadīkla, kuru pārslēgt uz režīmu FormMode.View.
Piemēri
Pilnīgus piemērus skatiet tēmā Datu veidlapu izkārtojuma izprašana.
Pievienojiet vadīklu Poga, tās rekvizītu Teksts iestatiet uz Save, un tās rekvizītam OnSelect iestatiet šādu formulu:
SubmitForm( EditForm )
Iestatiet Veidlapas vadīklas rekvizītu OnFailure uz tukšu un tās rekvizītu OnSuccess uz šādu formulu:
Atpakaļ()
Nodēvējiet vadīklu Label ar nosaukumu ErrorText un iestatiet tās rekvizītam Text šādu formulu:
EditForm.Error
Kad lietotājs atlasa pogu Saglabāt, jebkādas Veidlapas vadīklas izmaiņas tiek iesniegtas galvenajam datu avotam.
- Ja iesniegšana izdodas, visas izmaiņas tiek saglabātas vai, ja Veidlapas vadīkla ir režīmā Jauns, tiek izveidots ieraksts. ErrorText ir tukšs , un atkal tiek parādīts iepriekšējais ekrāns.
- Ja iesniegšana neizdodas, ErrorText rāda lietotājam draudzīgu kļūdas ziņojumu un pašreizējais ekrāns joprojām ir redzams, lai lietotājs varētu novērst problēmu un mēģināt vēlreiz.
Pievienojiet vadīklu Poga, tās rekvizītu Teksts iestatiet uz Atcelt, un tās rekvizītam OnSelect iestatiet šādu formulu:
ResetForm( EditForm ); Atpakaļ()
Kad lietotājs atlasa pogu Atcelt, Veidlapas vadīklas vērtības tiek atiestatītas uz tādām, kādas tās bija, pirms lietotājs sāka to rediģēt, no jauna parādās iepriekšējais ekrāns un Veidlapas vadīkla atgriežas režīmā Rediģēt, ja tā atradās režīmā Jauns.
Pievienojiet vadīklu Poga, tās rekvizītu Teksts iestatiet uz Jauns, un tās rekvizītam OnSelect iestatiet šādu formulu:
NewForm( EditForm ); Navigate( EditScreen, Nav )
Kad lietotājs atlasa pogu Jauns, Veidlapas vadīkla pārslēdzas uz režīmu Jauns, Veidlapas vadīklas datu avota noklusējuma vērtības aizpilda šo vadīklu un tiek parādīts ekrāns, kas satur Veidlapas vadīklu. Ja tiek palaista funkcija SubmitForm, ieraksts tiek izveidots, nevis atjaunināts.