EditForm, NewForm, , SubmitFormResetForm, un ViewForm funkcijas

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 vadīklas SubmitForm Button rekvizīta OnSelect funkciju, lai saglabātu visas veidlapas vadīklas izmaiņas datu avotā.

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.

SubmitFormpārbauda arī veidlapas rekvizītu Derīgs, kas ir visu veidlapas vadīklu kartes rekvizītu derīgu 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 ir izturējusi, SubmitForm iesniedz izmaiņas datu avotā.

• 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

Šī EditForm funkcija maina veidlapas vadīklas režīmu uz FormMode.Edit. Šajā režīmā veidlapas aizpildīšanai izmanto Veidlapas vadīklas rekvizīta Elements saturu. Ja funkcija tiek izpildīta SubmitForm , 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

Šī NewForm funkcija maina vadīklas Form 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 funkcija tiek izpildīta SubmitForm , kad veidlapa ir šajā režīmā, ieraksts tiek izveidots, nevis mainīts.

ResetForm

Funkcija ResetForm atiestata veidlapas saturu uz sākotnējām vērtībām, pirms lietotājs veica 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

Šī ViewForm funkcija maina veidlapas vadīklas režīmu uz FormMode.View. Šajā režīmā veidlapas aizpildīšanai izmanto Veidlapas vadīklas rekvizīta Elements saturu. Funkcijām SubmitForm un ResetForm nav nekādas ietekmes, kad tas ir šajā režīmā.

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( Veidlapas nosaukums )

• FormName - obligāts. Veidlapas vadīkla, kuru jāiesniedz datu avotam.

EditForm( Veidlapas nosaukums )

• FormName - obligāts. Veidlapas vadīkla, kuru pārslēgt uz režīmu FormMode.Edit.

NewForm( Veidlapas nosaukums )

• FormName - obligāts. Veidlapas vadīkla, kuru pārslēgt uz režīmu FormMode.New.

ResetForm( Veidlapas nosaukums )

• 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( Veidlapas nosaukums )

• 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.

1. Pievienojiet vadīklu Poga, tās rekvizītu Teksts iestatiet uz Save, un tās rekvizītam OnSelect iestatiet šādu formulu:

   SubmitForm( ) EditForm

2. Iestatiet Veidlapas vadīklas rekvizītu OnFailure uz tukšu un tās rekvizītu OnSuccess uz šādu formulu:

   Atpakaļ()

3. Nodēvējiet vadīklu Label ar nosaukumu ErrorText un iestatiet tās rekvizītam Text šādu formulu:

   EditForm. Kļūda

   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.

4. 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.

5. 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. Kad SubmitForm funkcija tiek izpildīta, ieraksts tiek izveidots, nevis atjaunināts.