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