EditForm, NewForm, SubmitForm, ResetForm және ViewForm функциялары
Мыналарға қолданылады:
Canvas қолданбалары
Edit form басқару элементінде элементті көріңіз, өңдеңіз немесе жасаңыз әрі басқару элементтерін ысырыңыз.
Шолу
Бұл функциялар Пішінді өңдеу басқару элементінің күйін өзгертеді. Пішін басқару элементі келесі режимдердің бірінде болуы мүмкін:
| Режим | Сипаттама |
|---|---|
| FormMode.Edit | Пішін бар жазбамен толтырылады және пайдаланушы өрістердің мәндерін өзгерте алады. Аяқтағаннан кейін пайдаланушы жазбаға енгізілген өзгерістерді сақтай алады. |
| FormMode.Жаңа | Пішін әдепкі мәндермен толтырылған және пайдаланушы өрістердің мәндерін өзгерте алады. Аяқтағаннан кейін пайдаланушы жазбаны деректер көзіне қоса алады. |
| FormMode.View | Пішін бар жазбамен толтырылады, бірақ пайдаланушы өрістердің мәндерін өзгерте алмайды. |
Сипаттама
Бұл функциялар жиі a Түйменің немесе Суреттің OnSelect формуласынан шақырылады. a12> басқару, осылайша пайдаланушы өңдеулерді сақтай алады, өңдеулерден бас тарта алады немесе жазба жасай алады. Толық шешімді жасау үшін басқару элементтерін және осы функцияларды бірге пайдалануға болады.
Бұл функциялар мәндерді қайтармайды.
Бұл функцияларды тек мінез-құлық формулаларында пайдалануға болады.
SubmitForm
«Пішін» басқару элементіндегі кез келген өзгерістерді деректер көзіне сақтау үшін «Түймешік» басқару элементінің OnSelect сипатындағы SubmitForm функциясын пайдаланыңыз.
Кез келген өзгертулерді жібермес бұрын, бұл функция міндетті деп белгіленген, я болмаса мәніне қатысты бір немесе бірнеше шектеуі бар кез келген өрісте тексеру мәселелері бар-жоғын тексереді. Бұл мінез-құлық Validate функциясының мінез-құлқына сәйкес келеді.
SubmitForm сонымен қатар Valid пішіннің қасиетін тексереді, ол барлық Жарамды < жиыны болып табылады. /a18>Пішін басқару элементі қамтитын карта басқару элементтерінің сипаттары. Мәселе орын алса, деректер жіберілмейді әрі «Пішін» басқару элементінің 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.Жаңа | DisplayMode.Edit | Деректер карталары мен басқару элементтерін өңдеуге болады, жаңа жазбаны қабылдауға дайын. |
| FormMode.View | DisplayMode.View | Деректер карталары мен басқару элементтерін өңдеу мүмкін емес және көруге оңтайландырылған. |
Синтаксис
Жіберу пішіні( Пішіннің аты )
- FormName - Міндетті. Деректер көзіне жіберетін «Пішін» басқару элементі.
Өңдеу пішімі( Пішін атауы )
- FormName - Міндетті. FormMode.Edit режиміне ауыстыратын «Пішін» басқару элементі.
Жаңа пішін( Пішін атауы )
- FormName - Міндетті. FormMode.New режиміне ауыстыратын «Пішін» басқару элементі.
ResetForm( Пішін атауы )
- FormName - Міндетті. Бастапқы мәндерге ысыратын «Пішін» басқару элементі. Сондай-ақ пішінді FormMode.New режимінен FormMode.Edit режиміне ауыстырады.
ViewForm( Пішін атауы )
- FormName - Міндетті. FormMode.View режиміне ауыстыратын «Пішін» басқару элементі.
Мысалдар
Толық мысалдарды Деректер пішіндерін түсіну бөлімінен қараңыз.
«Түймешік» басқару элементін қосыңыз, оның Мәтін сипатын Сақтау жазуын көрсетуге орнатыңыз және оның OnSelect сипатын мына формулаға орнатыңыз:
Жіберу пішіні( EditForm )
«Пішін» басқару элементінің OnFailure сипатын бос мәнге орнатыңыз және оның OnSuccess сипатын мына формулаға орнатыңыз:
Артқа()
Label басқару элементіне ErrorText атауын беріңіз және оның Мәтін сипатын мына формулаға орнатыңыз:
EditForm. Error
Пайдалнаушы Сақтау түймесін басқанда, «Пішін» басқару элементіндегі кез келген өзгерістер негізінде жатқан деректер көзіне жіберіледі.
- Егер жіберу сәтті болса, кез келген өзгертулер сақталады немесе егер «Пішін» басқару элементі Жаңа режимінде болса, жазба жасалады. ErrorText бос және алдыңғы экран қайта пайда болады.
- Егер жіберу сәтсіз болса, ErrorText түсінікті қате туралы хабарды көрсетеді, ал ағымдағы экран көрініп тұрады, осылайша пайдаланушы мәселені түзетіп, әрекетті қайталай алады.
«Түймешік» басқару элементін қосыңыз, оның Мәтін сипатын Бас тарту жазуын көрсетуге орнатыңыз және оның OnSelect сипатын мына формулаға орнатыңыз:
ResetForm( EditForm ); Артқа()
Пайдаланушы Бас тарту түймесін басқанда, «Пішін» басқару элементіндегі мәндер пайдаланушы өңдеуді бастамай тұрып болғанға ысырылады, алдыңғы экран қайта көрінеді және Жаңа режимінде болған болса, «Пішін» басқару элементі Өңдеу режиміне оралады.
«Түймешік» басқару элементін қосыңыз, оның Мәтін сипатын Жаңа жазуын көрсетуге орнатыңыз және оның OnSelect сипатын мына формулаға орнатыңыз:
NewForm( EditForm ); Шарлау (EditScreen, Ешбірі)
Пайдаланушы Жаңа түймешігін басқанда, «Пішін» басқару элементі Жаңа режиміне ауысады, «Пішін» басқару элементінің деректер көзінің әдепкі мәндері сол басқару элементін толтырады және «Пішін» басқару элементін қамтитын экран көрінеді. SubmitForm функциясы орындалғанда, жазба жаңартылмайды, ал жасалады.