Бөлісу құралы:

EditForm, NewForm, SubmitForm, ResetForm, және ViewForm функциялары

Мыналарға қолданылады: Canvas қолданбалары

Edit form басқару элементінде элементті көріңіз, өңдеңіз немесе жасаңыз әрі басқару элементтерін ысырыңыз.

Шолу

Бұл функциялар Пішінді өңдеу басқару элементінің күйін өзгертеді. Пішін басқару элементі келесі режимдердің бірінде болуы мүмкін:

Режим Сипаттама
FormMode.Edit Пішін бар жазбамен толтырылады және пайдаланушы өрістердің мәндерін өзгерте алады. Аяқтағаннан кейін пайдаланушы жазбаға енгізілген өзгерістерді сақтай алады.
FormMode.Жаңа Пішін әдепкі мәндермен толтырылған және пайдаланушы өрістердің мәндерін өзгерте алады. Аяқтағаннан кейін пайдаланушы жазбаны деректер көзіне қоса алады.
FormMode.View Пішін бар жазбамен толтырылады, бірақ пайдаланушы өрістердің мәндерін өзгерте алмайды.

Сипаттама

Бұл функциялар жиі a Түйменің немесе Суреттің OnSelect формуласынан шақырылады. a12> басқару, осылайша пайдаланушы өңдеулерді сақтай алады, өңдеулерден бас тарта алады немесе жазба жасай алады. Толық шешімді жасау үшін басқару элементтерін және осы функцияларды бірге пайдалануға болады.

Бұл функциялар мәндерді қайтармайды.

Бұл функцияларды тек мінез-құлық формулаларында пайдалануға болады.

SubmitForm

Пішін басқару элементіндегі кез келген өзгерістерді деректер көзіне сақтау үшін түймешік басқару элементінің Қосулы сипатындағы функцияны пайдаланыңыз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.Жаңа DisplayMode.Edit Деректер карталары мен басқару элементтерін өңдеуге болады, жаңа жазбаны қабылдауға дайын.
FormMode.View DisplayMode.View Деректер карталары мен басқару элементтерін өңдеу мүмкін емес және көруге оңтайландырылған.

Синтаксис

SubmitForm( ПішінАтауы )

  • ПішінАты - Міндетті. Деректер көзіне жіберетін «Пішін» басқару элементі.

EditForm( ПішінАтауы )

  • ПішінАты - Міндетті. FormMode.Edit режиміне ауыстыратын «Пішін» басқару элементі.

NewForm( ПішінАтауы )

  • ПішінАты - Міндетті. FormMode.New режиміне ауыстыратын «Пішін» басқару элементі.

ResetForm( ПішінАтауы )

  • ПішінАты - Міндетті. Бастапқы мәндерге ысыратын «Пішін» басқару элементі. Сондай-ақ пішінді FormMode.New режимінен FormMode.Edit режиміне ауыстырады.

ViewForm( ПішінАтауы )

  • ПішінАты - Міндетті. FormMode.View режиміне ауыстыратын «Пішін» басқару элементі.

Мысалдар

Толық мысалдарды Деректер пішіндерін түсіну бөлімінен қараңыз.

  1. «Түймешік» басқару элементін қосыңыз, оның Мәтін сипатын Сақтау жазуын көрсетуге орнатыңыз және оның OnSelect сипатын мына формулаға орнатыңыз:

    SubmitForm EditForm ( )

  2. «Пішін» басқару элементінің OnFailure сипатын бос мәнге орнатыңыз және оның OnSuccess сипатын мына формулаға орнатыңыз:

    Артқа()

  3. Label басқару элементіне ErrorText атауын беріңіз және оның Мәтін сипатын мына формулаға орнатыңыз:

    EditForm. Қате

    Пайдалнаушы Сақтау түймесін басқанда, «Пішін» басқару элементіндегі кез келген өзгерістер негізінде жатқан деректер көзіне жіберіледі.

    • Егер жіберу сәтті болса, кез келген өзгертулер сақталады немесе егер «Пішін» басқару элементі Жаңа режимінде болса, жазба жасалады. ErrorTextбос және алдыңғы экран қайта пайда болады.
    • Егер жіберу сәтсіз болса, ErrorText түсінікті қате туралы хабарды көрсетеді, ал ағымдағы экран көрініп тұрады, осылайша пайдаланушы мәселені түзетіп, әрекетті қайталай алады.

  4. «Түймешік» басқару элементін қосыңыз, оның Мәтін сипатын Бас тарту жазуын көрсетуге орнатыңыз және оның OnSelect сипатын мына формулаға орнатыңыз:

    ResetForm( EditForm ); Артқы жағы()

    Пайдаланушы Бас тарту түймесін басқанда, «Пішін» басқару элементіндегі мәндер пайдаланушы өңдеуді бастамай тұрып болғанға ысырылады, алдыңғы экран қайта көрінеді және Жаңа режимінде болған болса, «Пішін» басқару элементі Өңдеу режиміне оралады.

  5. «Түймешік» басқару элементін қосыңыз, оның Мәтін сипатын Жаңа жазуын көрсетуге орнатыңыз және оның OnSelect сипатын мына формулаға орнатыңыз:

    NewForm( EditForm ); Navigate( EditScreen, None )

    Пайдаланушы Жаңа түймешігін басқанда, «Пішін» басқару элементі Жаңа режиміне ауысады, «Пішін» басқару элементінің деректер көзінің әдепкі мәндері сол басқару элементін толтырады және «Пішін» басқару элементін қамтитын экран көрінеді. Функция іске қосылған кезде SubmitForm , жаңартудың орнына жазба жасалады.

  • Last updated on