Funkcie EditForm, NewForm, SubmitForm, ResetForm a ViewForm

Vzťahuje sa na: aplikácie Canvas

Slúžia na zobrazenie, úpravy a vytváranie položiek, ukladanie obsahu a obnovenie ovládacích prvkov v ovládacom prvku Úprava formulára.

Prehľad

Tieto funkcie zmenia stav ovládacieho prvku Úprava formulára. Ovládací prvok formulára môže byť v jednom z týchto režimov:

Popis

Tieto funkcie sa často vyvolávajú z OnSelect vzorca tlačidla alebo obrázka ovládanie, aby používateľ mohol uložiť úpravy, opustiť úpravy alebo vytvoriť záznam. Ovládacie prvky môžete použiť spoločne s týmito funkciami a vytvoriť tak kompletné riešenie.

Tieto funkcie nevracajú žiadnu hodnotu.

Môžete tieto funkcie použiť iba vo vzorcoch správania.

SubmitForm

Funkcia SubmitForm vo vlastnosti OnSelect ovládacieho prvku Tlačidlo slúži na ukladanie všetkých zmien v ovládacom prvku Formulár do zdroja údajov.

Pred odoslaním akýchkoľvek zmien táto funkcia skontroluje problémy s overením v prípade všetkých polí, ktoré sú označené ako povinné alebo ktorých hodnota má nastavené nejaké obmedzenie. Toto správanie sa zhoduje so správaním funkcie Validate.

SubmitForm tiež skontroluje Platnú vlastnosť formulára, ktorá je súhrnom všetkých Platných vlastnosti ovládacích prvkov karty , ktoré obsahuje ovládací prvok Formulár. Ak dôjde k problému, údaje sa neodošlú a vlastnosti Error a ErrorKind ovládacieho prvku Formulár sa nastavia zodpovedajúcim spôsobom.

V prípade úspešného overenia odošle funkcia SubmitForm zmenu do zdroja údajov.

• Ak bude úspešný, spustí sa správanie OnSuccess formulára a Chyba a Druh chyby vlastnosti sú vymazané. Ak bol formulár v režime FormMode.New, vráti sa späť do režimu FormMode.Edit.
• V prípade neúspechu sa spustí správanie formulára OnFailure a spustí sa Error a ErrorKind vlastnosti sú nastavené podľa toho. Režim formulára zostane bez zmeny.

EditForm

Funkcia EditForm zmení režim ovládacieho prvku Formulár na hodnotu FormMode.Edit. V tomto režime slúži obsah vlastnosti Item ovládacieho prvku Formulár na naplnenie formulára. Ak sa spustí funkcia SubmitForm v prípade formulára v tomto režime, záznam sa nevytvorí, ale zmení. FormMode.Edit je predvolený režim ovládacieho prvku Formulár.

NewForm

Funkcia NewForm zmení režim ovládacieho prvku Formulár na hodnotu FormMode.New. V tomto režime sa obsah vlastnosti Item ovládacieho prvku Formulár ignoruje a formulár sa naplní predvolenými hodnotami vlastnosti DataSource ovládacieho prvku Formulár. Ak sa spustí funkcia SubmitForm v prípade formulára v tomto režime, záznam sa vytvorí, ale nezmení.

ResetForm

Než používateľ vykoná zmeny, funkcia ResetForm obnoví obsah formulára na pôvodné hodnoty. Ak je formulár v režime FormMode.New, obnoví sa na režim FormMode.Edit. Spustí sa tiež akcia OnReset ovládacieho prvku formulára. Pomocou funkcie Reset môžete tiež obnoviť jednotlivé ovládacie prvky, ale iba v rámci formulára.

ViewForm

Funkcia ViewForm zmení režim ovládacieho prvku Formulár na hodnotu FormMode.View. V tomto režime slúži obsah vlastnosti Item ovládacieho prvku Formulár na naplnenie formulára. V tomto režime nemajú funkcie SubmitForm a ResetForm žiadny vplyv.

Vlastnosť DisplayMode

Aktuálny režim je možné čítať prostredníctvom vlastnosti Mode. Tento režim tiež určuje hodnotu vlastnosti DisplayMode, ktorú môžu používať údajové karty a ovládacie prvky v rámci ovládacieho prvku formulára. Vlastnosť DisplayMode karty údajov sa často nastaví na hodnotu Parent.DisplayMode (odkazujúcu na formulár) rovnako ako vlastnosť DisplayMode ovládacieho prvku (odkazujúcu na kartu údajov):

Syntax

SubmitForm( FormName )

• FormName – povinné. Ovládací prvok formulára na odoslanie do zdroja údajov.

EditForm( FormName )

• FormName – povinné. Ovládací prvok formulára na prepnutie do režimu FormMode.Edit.

NewForm( FormName )

• FormName – povinné. Ovládací prvok formulára na prepnutie do režimu FormMode.New.

ResetForm( FormName )

• FormName – povinné. Ovládací prvok formulára na obnovenie na počiatočné hodnoty. Tiež prepína formulár z režimu FormMode.New do režimu FormMode.Edit.

ViewForm( FormName )

• FormName – povinné. Ovládací prvok formulára na prepnutie do režimu FormMode.View.

Príklady

Úplné príklady nájdete v článku Princípy údajových formulárov.

1. Pridajte ovládací prvok Tlačidlo, nastavte jeho vlastnosť Text na hodnotu Save a nastavte jeho vlastnosť OnSelect na tento vzorec:

   SubmitForm( EditForm )

2. Nastavte vlastnosť OnFailure ovládacieho prvku Formulár na prázdnu hodnotu a jeho vlastnosť OnSuccess na tento vzorec:

   Back()

3. Pomenujte ovládací prvok Označenie ako ErrorText a nastavte jeho vlastnosť Text na tento vzorec:

   EditForm.Error

   Keď používateľ vyberie tlačidlo Save, všetky zmeny v ovládacom prvku Formulár sa pošlú do podkladového zdroja údajov.

   • Ak sa odoslanie podarí, všetky zmeny sa uložia, alebo v prípade, že je ovládací prvok Formulár v režime New, vytvorí sa záznam. Vlastnosť ErrorText je prázdna a znova sa objaví predchádzajúca obrazovka.
   • Ak sa odoslanie nepodarí, ErrorText zobrazí prívetivé chybové hlásenie a aktuálna obrazovka zostane zobrazená, aby používateľ mohol opraviť problém a akciu zopakovať.

4. Pridajte ovládací prvok Tlačidlo, nastavte jeho vlastnosť Text na Cancel a vlastnosť OnSelect nastavte na tento vzorec:

   ResetForm( EditForm ); Back()

   Keď používateľ vyberie tlačidlo Cancel, hodnoty v ovládacom prvku Formulár sa obnovia na hodnoty, ktoré ovládací prvok obsahoval pred tým, než používateľ začal s úpravami. Znova sa objaví predchádzajúca obrazovka a ovládací prvok Formulár sa vráti do režimu Edit v prípade, že bol v režime New.

5. Pridajte ovládací prvok Tlačidlo, nastavte jeho vlastnosť Text na hodnotu New a nastavte jeho vlastnosť OnSelect na tento vzorec:

   NewForm( EditForm ); Navigate( EditScreen, None )

   Keď používateľ vyberie tlačidlo New, ovládací prvok Formulár sa prepne do režimu New a naplní sa predvolenými hodnotami zo zdroja údajov a zobrazí sa obrazovka obsahujúca tento ovládací prvok. Pri spustení funkcie SubmitForm sa záznam neaktualizuje, ale vytvorí sa nový.