EditForm, NewForm, SubmitForm, ResetForm және ViewForm функциялары
Мыналарға қолданылады:
Canvas қолданбалары
Edit form басқару элементінде элементті көріңіз, өңдеңіз немесе жасаңыз әрі басқару элементтерін ысырыңыз.
Шолу
Бұл функциялар Пішінді өңдеу басқару элементінің күйін өзгертеді. Пішін басқару элементі келесі режимдердің бірінде болуы мүмкін:
| Режим | Сипаттама |
|---|---|
| FormMode.Edit | Пішін бар жазбамен толтырылады және пайдаланушы өрістердің мәндерін өзгерте алады. Аяқтағаннан кейін пайдаланушы жазбаға енгізілген өзгерістерді сақтай алады. |
| FormMode.New | Пішін әдепкі мәндермен толтырылған және пайдаланушы өрістердің мәндерін өзгерте алады. Аяқтағаннан кейін пайдаланушы жазбаны деректер көзіне қоса алады. |
| FormMode.View | Пішін бар жазбамен толтырылады, бірақ пайдаланушы өрістердің мәндерін өзгерте алмайды. |
Сипаттама
Бұл функциялар жиі Түйменің немесе Суреттің OnSelect формуласынан шақырылады, осылайша пайдаланушы өңдеулерді сақтай алады, өңдеулерден бас тарта алады немесе жазба жасай алады. Толық шешімді жасау үшін басқару элементтерін және осы функцияларды бірге пайдалануға болады.
Бұл функциялар мәндерді қайтармайды.
Бұл функцияларды тек мінез-құлық формулаларында пайдалануға болады.
SubmitForm
«Пішін» басқару элементіндегі кез келген өзгерістерді деректер көзіне сақтау үшін «Түймешік» басқару элементінің OnSelect сипатындағы SubmitForm функциясын пайдаланыңыз.
Кез келген өзгертулерді жібермес бұрын, бұл функция міндетті деп белгіленген, я болмаса мәніне қатысты бір немесе бірнеше шектеуі бар кез келген өрісте тексеру мәселелері бар-жоғын тексереді. Бұл мінез-құлық Validate функциясының мінез-құлқына сәйкес келеді.
SubmitForm сонымен қатар пішіннің Жарамды сипатын тексереді, ол "Пішін" басқару элементі қамтитын Карта басқару элементтерінің барлық Жарамды сипаттарының жиынтығы болып табылады. Мәселе орын алса, деректер жіберілмейді әрі «Пішін» басқару элементінің Error және ErrorKind сипаттары сәйкесінше орнатылады.
Тексеру өтсе, SubmitForm өзгерісті деректер көзіне жібереді.
- Сәтті болса, пішіннің OnSuccess әрекеті орындалады және Қате және ErrorKind сипаттар тазартылады. Пішін FormMode.New режимінде болған болса, ол FormMode.Edit режиміне оралады.
- Сәтсіз болса, пішіннің OnFailure әрекеті орындалады және Қате және ErrorKind қасиеттері сәйкес орнатылады. Пішіннің режимі өзгермейді.
EditForm
EditForm функциясы «Пішін» басқару элементінің режимін FormMode.Edit дегенге өзгертеді. Бұл режимде «Пішін» басқару элементінің Элемент сипатының мазмұны пішінді толтыру үшін пайдаланылады. Пішін осы режимде болғанда SubmitForm функциясы орындалса, жазба жасалмайды, өзгертіледі. FormMode.Edit — «Пішін» басқару элементінің әдепкі мәні.
Ескертпе
Пішін өңдеу күйі және Элемент бос болғанда, деректер картасының сипаттары бағаланбайды және әдепкі мәндерді қайтарады.
NewForm
NewForm функциясы «Пішін» басқару элементінің режимін FormMode.New дегенге өзгертеді. Бұл режимде «Пішін» басқару элементінің Элемент сипатының мазмұны елебейді және «Пішін» басқару элементінің DataSource сипатының әдепкі мәндері пішінді толтырады. Пішін осы режимде болғанда SubmitForm функциясы орындалса, жазба өзгертілмейді, жасалады.
ResetForm
ResetForm функциясы пайдаланушы кез келген өзгертулер жасамай тұрып пішіннің мазмұнын бастапқы мәндеріне ысырады. Пішін FormMode.New режимінде болса, пішін FormMode.Edit режиміне ысырылады. Сондай-ақ «Пішін» басқару элементінің OnReset мінез-құлқы орындалады. Сондай-ақ Reset функциясы арқылы жеке басқару элементтерін ысыруға болады, бірақ тек пішін ішінен.
ViewForm
ViewForm функциясы «Пішін» басқару элементінің режимін FormMode.View дегенге өзгертеді. Бұл режимде «Пішін» басқару элементінің Элемент сипатының мазмұны пішінді толтыру үшін пайдаланылады. Бұл режимде болғанда, SubmitForm және ResetForm функцияларының әсері болмайды.
DisplayMode сипаты
Ағымдағы режимді Mode сипаты арқылы оқуға болады. Сондай-ақ бұл режим деректер карталары және «Пішін» басқару элементінің ішіндегі басқару элементтері пайдалана алатын DisplayMode сипатын анықтайды. Көбінесе, деректер картасының DisplayMode сипаты Parent.DisplayMode (пішінге сілтеме жасау) режиміне орнатылады, басқару элементінің DisplayMode сипаты да (деректер картасына сілтеме жасау):
| Режим | DisplayMode | Сипаттама |
|---|---|---|
| FormMode.Edit | DisplayMode.Edit | Деректер карталары мен басқару элементтерін өңдеуге болады, жазбаға өзгерістерді қабылдауға дайын. |
| FormMode.New | DisplayMode.Edit | Деректер карталары мен басқару элементтерін өңдеуге болады, жаңа жазбаны қабылдауға дайын. |
| FormMode.View | DisplayMode.View | Деректер карталары мен басқару элементтерін өңдеу мүмкін емес және көруге оңтайландырылған. |
Синтаксис
SubmitForm( FormName )
- FormName - Міндетті. Деректер көзіне жіберетін «Пішін» басқару элементі.
EditForm( FormName )
- FormName - Міндетті. FormMode.Edit режиміне ауыстыратын «Пішін» басқару элементі.
NewForm( FormName )
- FormName - Міндетті. FormMode.New режиміне ауыстыратын «Пішін» басқару элементі.
ResetForm( FormName )
- FormName - Міндетті. Бастапқы мәндерге ысыратын «Пішін» басқару элементі. Сондай-ақ пішінді FormMode.New режимінен FormMode.Edit режиміне ауыстырады.
ViewForm( FormName )
- FormName - Міндетті. FormMode.View режиміне ауыстыратын «Пішін» басқару элементі.
Мысалдар
Толық мысалдарды Деректер пішіндерін түсіну бөлімінен қараңыз.
«Түймешік» басқару элементін қосыңыз, оның Мәтін сипатын Сақтау жазуын көрсетуге орнатыңыз және оның OnSelect сипатын мына формулаға орнатыңыз:
SubmitForm( EditForm )
«Пішін» басқару элементінің OnFailure сипатын бос мәнге орнатыңыз және оның OnSuccess сипатын мына формулаға орнатыңыз:
Back()
Label басқару элементіне ErrorText атауын беріңіз және оның Мәтін сипатын мына формулаға орнатыңыз:
EditForm.Error
Пайдалнаушы Сақтау түймесін басқанда, «Пішін» басқару элементіндегі кез келген өзгерістер негізінде жатқан деректер көзіне жіберіледі.
- Егер жіберу сәтті болса, кез келген өзгертулер сақталады немесе егер «Пішін» басқару элементі Жаңа режимінде болса, жазба жасалады. ErrorText — бос және алдыңғы экран қайта көрінеді.
- Егер жіберу сәтсіз болса, ErrorText түсінікті қате туралы хабарды көрсетеді, ал ағымдағы экран көрініп тұрады, осылайша пайдаланушы мәселені түзетіп, әрекетті қайталай алады.
«Түймешік» басқару элементін қосыңыз, оның Мәтін сипатын Бас тарту жазуын көрсетуге орнатыңыз және оның OnSelect сипатын мына формулаға орнатыңыз:
ResetForm( EditForm ); Back()
Пайдаланушы Бас тарту түймесін басқанда, «Пішін» басқару элементіндегі мәндер пайдаланушы өңдеуді бастамай тұрып болғанға ысырылады, алдыңғы экран қайта көрінеді және Жаңа режимінде болған болса, «Пішін» басқару элементі Өңдеу режиміне оралады.
«Түймешік» басқару элементін қосыңыз, оның Мәтін сипатын Жаңа жазуын көрсетуге орнатыңыз және оның OnSelect сипатын мына формулаға орнатыңыз:
NewForm( EditForm ); Navigate( EditScreen, None )
Пайдаланушы Жаңа түймешігін басқанда, «Пішін» басқару элементі Жаңа режиміне ауысады, «Пішін» басқару элементінің деректер көзінің әдепкі мәндері сол басқару элементін толтырады және «Пішін» басқару элементін қамтитын экран көрінеді. SubmitForm функциясы орындалғанда, жазба жаңартылмайды, ал жасалады.