Функције ЕдитФорм, НеwФорм, СубмитФорм, РесетФорм и ВиеwФорм
Важи за: Цанвас 
апликације
Прегледајте, измените или креирајте ставку, сачувајте садржај и ресетујте контроле у оквиру контроле Edit form.
Преглед
Ове функције мењају статус контроле Уређивање обрасца. Контрола обрасца може бити у једном од ових режима:
| Режим | Опис |
|---|---|
| FormMode.Edit | Образац се попуњава постојећим записом и корисник може да мења вредности поља. Када завршите, корисник може да сачува измене записа. |
| FormMode.New | Образац је попуњен подразумеваним вредностима и корисник може да мења вредности поља. Када завршите, корисник може да дода запис у извор података. |
| FormMode.View | Образац се попуњава постојећим записом, али корисник не може да мења вредности поља. |
Опис
Ове функције се често позивају из ОнСелецт формуле контроле дугмета или слике тако да корисник може да сачува уређивања, напусти уређивање или креира запис. Можете да користите контроле и ове функције заједно да бисте креирали потпуно решење.
Ове функције не враћају вредност.
Ове функције можете користити само у оквиру формула понашања.
SubmitForm
Користите функцију SubmitForm у својству OnSelect контроле дугмета да бисте сачували све промене у контроли обрасца у извору података.
Пре прослеђивања било каквих промена, ова функција проверава да ли постоје ли проблеми са валидацијом са било којим пољем које је означено као потребно или које има једно или више ограничења за вредност. Ово понашање се поклапа са понашањем функције Validate.
Образац за прослеђивање такође проверава важеће својство Обрасца, што је агрегација ... свих важећих својстава картица контрола које контрола обрасца садржи. Ако дође до проблема, подаци се не прослеђују, а својства Грешка и ErrorKind контроле обрасца постављена су у складу с тим.
Ако валидација прође, SubmitForm прослеђује промену у извор података.
- Ако успете, покреће се понашање ОнСуццесс обрасца и чисте се својства Еррор анд ЕррорКинд . Ако је образац био у режиму FormMode.New, враћен је у режим FormMode.Edit.
- Ако не успете, понашање обрасца" ОнФаилуре" се покреће, а својства "Грешка" и " ЕррорКинд" су постављена у складу са тим. Режим обрасца је непромењен.
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
Тренутни режим се може очитати унутар својства Режим. Режим такође одређује вредност својства DisplayMode, које могу користити картице података и контроле у оквиру контроле обрасца. Често ће својство Режим приказа картице података бити постављено на Parent.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()
Назоците контролу Ознака ErrorText и подесите њено својство Text према овој формули:
EditForm.Error
Када корисник изабере дугме Сачувај, све промене у контроли обрасца се прослеђују у основни извор података.
- Ако пријава успе, све промене се спремају или, ако је контрола обрасца у режиму Ново, креира се запис. ErrorText је празна, а претходни екран се поново појављује.
- Ако пријава не успе, ErrorText приказује поруку о грешци прилагођену корисничку, а тренутни екран остаје видљив како би корисник могао да исправи проблем и покуша поново.
Додајте контролу Дугме, подесите својство Текст да покаже Откажи, а затим и поставите својство OnSelect према овој формули:
ResetForm( EditForm ); Back()
Када корисник одабере дугме Откажи, вредности у контроли обрасца се враћају на оно што су биле пре него што је корисник почео да га уређује, појављује се претходни екран, а контрола обрасца се враћа у режим Уреди ако је била у режиму Ново.
Додајте контролу Дугме, подесите својство Текст да покаже Ново, а затим и поставите својство OnSelect према овој формули:
NewForm( EditForm ); Navigate( EditScreen, None )
Када корисник изабере дугме Ново, контрола обрасца прелази у режим Ново, подразумеване вредности за извор података контроле обрасца попуњавају ту контролу, а појављује се екран који садржи контролу обрасца. Када је функција SubmitForm покренута, запис се креира уместо да се ажурира.