EditForm, NewForm, SubmitForm, ResetForm, и ViewForm функције

Односи се на: Цанвас апликације

Прегледајте, измените или креирајте ставку, сачувајте садржај и ресетујте контроле у оквиру контроле Edit form.

Преглед

Ове функције мењају статус контроле Уређивање обрасца. Контрола обрасца може бити у једном од ових режима:

Режим Опис
ФормМоде.Едит Образац се попуњава постојећим записом и корисник може да мења вредности поља. Када завршите, корисник може да сачува измене записа.
ФормМоде.Нев Образац је попуњен подразумеваним вредностима и корисник може да мења вредности поља. Када завршите, корисник може да дода запис у извор података.
ФормМоде.Виев Образац се попуњава постојећим записом, али корисник не може да мења вредности поља.

Опис

Ове функције се често позивају из формуле ... ОнСелецт дугмета или контроле слике тако да корисник може да сачува измене, напусти измене или креира запис. Можете да користите контроле и ове функције заједно да бисте креирали потпуно решење.

Ове функције не враћају вредност.

Ове функције можете користити само у оквиру формула понашања.

SubmitForm

Користите SubmitForm функцију у ОнСелецт особине контроле дугмета да сачувате све промене у контроли обрасца у извор података.

Пре прослеђивања било каквих промена, ова функција проверава да ли постоје ли проблеми са валидацијом са било којим пољем које је означено као потребно или које има једно или више ограничења за вредност. Ово понашање се поклапа са понашањем функције Validate.

SubmitForm такође проверава исправну особину обрасца, која је агрегација свих важећих својстава контрола картице које садржи контрола обрасца. Ако дође до проблема, подаци се не прослеђују, а својства Грешка и ErrorKind контроле обрасца постављена су у складу с тим.

Ако валидација прође, SubmitForm шаље промену извору података.

EditForm

Функција EditForm мења режим контроле обрасца у ФормМоде.Едит . У овом режиму, садржај својства Ставка контроле обрасца се користи за попуњавање обрасца. Ако SubmitForm се функција покреће када је образац у овом режиму, запис се мења, а не креира. ФормМоде .Едит је основно за Форм контролу.

Белешка

Када је образац у < ДИЦТ__режим уређивања > едит моде и ставка је нулл, подаци картица својства се не процењују и вратиће подразумеване вредности.

NewForm

Функција NewForm мења режим контроле обрасца у ФормМоде.Нев . У овом режиму, садржај својства Ставка контроле обрасца се игнорише, а подразумеване вредности својства DataSource обрасца попуњавају образац. Ако SubmitForm се функција покреће када је образац у овом режиму, запис се креира, а не мења.

ResetForm

Функција ResetForm ресетује садржај обрасца на њихове почетне вредности, пре него што је корисник направио било какве измене. Ако је образац у режиму FormMode.New, образац је ресетован у режим FormMode.Edit. Понашање контроле OnReset обрасца такође се покреће. Такође можете ресетовати појединачне контроле помоћу функције Reset, али само унутар обрасца.

ViewForm

Функција ViewForm мења режим контроле обрасца у ФормМоде.Виеw . У овом режиму, садржај својства Ставка контроле обрасца се користи за попуњавање обрасца. Функције SubmitForm и ResetForm немају ефекта када су у овом режиму.

Својство DisplayMode

Тренутни режим се може очитати унутар својства Режим. Режим такође одређује вредност својства DisplayMode, које могу користити картице података и контроле у оквиру контроле обрасца. Често ће својство Режим приказа картице података бити постављено на Parent.DisplayMode (упућује на образац), као и својство Режим приказа контроле (упућује на картицу података):

Режим DisplayMode Опис
ФормМоде.Едит ДисплаyМоде.Едит Картице података и контроле се могу уређивати, спремне да прихвате промене у запису.
ФормМоде.Нев ДисплаyМоде.Едит Картице података и контроле се могу уређивати, спремне да прихвате нови запис.
ФормМоде.Виев ДисплаyМоде.Виев Картице података и контроле се не могу уређивати или оптимизовати за гледање.

Синтакса

SubmitForm( ФормНаме )

  • ФормНаме - Обавезно. Контролу обрасца коју треба проследити у извор података.

EditForm( ФормНаме )

  • ФормНаме - Обавезно. Контрола обрасца за прелазак на режим FormMode.Edit.

NewForm( ФормНаме )

  • ФормНаме - Обавезно. Контрола обрасца за прелазак на режим FormMode.New.

ResetForm( ФормНаме )

  • ФормНаме - Обавезно. Контрола обрасца за враћање на почетне вредности. Такође пребацује образац из режима FormMode.New у режим FormMode.Edit.

ViewForm( ФормНаме )

  • ФормНаме - Обавезно. Контрола обрасца за прелазак на режим FormMode.View.

Примери

Погледајте Разумевање образаца података за потпуне примере.

  1. Додајте контролу Дугме, подесите својство Текст да покаже Сачувај, а затим и поставите својство OnSelect према овој формули:

    SubmitForm( EditForm )

  2. Подесите својство OnFailure контроле обрасца на празно и његово својство OnSuccess према овој формули:

    Назад()

  3. Назоците контролу ОзнакаErrorText и подесите њено својство Text према овој формули:

    EditForm. Грешка

    Када корисник изабере дугме Сачувај, све промене у контроли обрасца се прослеђују у основни извор података.

    • Ако пријава успе, све промене се спремају или, ако је контрола обрасца у режиму Ново, креира се запис. ЕррорТект је празан и претходни екран се поново појављује.
    • Ако пријава не успе, ErrorText приказује поруку о грешци прилагођену корисничку, а тренутни екран остаје видљив како би корисник могао да исправи проблем и покуша поново.
  4. Додајте контролу Дугме, подесите својство Текст да покаже Откажи, а затим и поставите својство OnSelect према овој формули:

    ResetForm( EditForm ); Назад()

    Када корисник одабере дугме Откажи, вредности у контроли обрасца се враћају на оно што су биле пре него што је корисник почео да га уређује, појављује се претходни екран, а контрола обрасца се враћа у режим Уреди ако је била у режиму Ново.

  5. Додајте контролу Дугме, подесите својство Текст да покаже Ново, а затим и поставите својство OnSelect према овој формули:

    NewForm( EditForm ); Навигација ( ЕдитСцреен, ниједан )

    Када корисник изабере дугме Ново, контрола обрасца прелази у режим Ново, подразумеване вредности за извор података контроле обрасца попуњавају ту контролу, а појављује се екран који садржи контролу обрасца. Када SubmitForm се функција покрене, запис се креира уместо да се ажурира.