EditForm, NewForm, SubmitForm, ResetForm, a ViewForm funkcie

Platí pre: 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:

Režim	Popis
FormMode.Edit	Formulár sa naplní existujúcim záznamom a používateľ môže upraviť hodnoty polí. Po dokončení môže používateľ zmeny záznamu uložiť.
FormMode.New	Formulár sa vyplní predvolenými hodnotami a používateľ môže upraviť hodnoty polí. Po dokončení môže používať pridať záznam do zdroja údajov.
FormMode.View	Formulár sa naplní existujúcim záznamom, alebo používateľ nemôže upravovať hodnoty polí.

Popis

Tieto funkcie sa často vyvolávajú z OnSelect vzorca tlačidla alebo obrázku 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

SubmitForm Použite funkciu vo vlastnosti OnSelect ovládacieho prvku Tlačidlo na uloženie 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ž kontroluje vlastnosť Valid ovládacieho prvku Formulár, ktorá predstavuje agregáciu všetkých vlastností Valid ovládacích prvkov Karta , ktoré ovládací prvok Formulár obsahuje. 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.

Ak overenie prebehne, SubmitForm odošle zmenu do zdroja údajov.

• Ak bude úspešný, spustí sa správanie formulára OnSuccess a Error a ErrorKind 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 Pri zlyhaní a spustí sa Chyba a Druh chyby 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 SubmitForm funkcia spustí, keď je formulár v tomto režime, záznam sa zmení, nevytvorí. FormMode.Edit je predvolený pre ovládací prvok Formulár.

Poznámka

Keď je formulár v režim úprav a položka má hodnotu null, vlastnosti údajov karta sa nevyhodnotia a vrátia predvolené hodnoty.

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 SubmitForm funkcia spustí, keď je formulár v tomto režime, záznam sa vytvorí, nezmení.

ResetForm

Predtým ResetForm , ako používateľ vykoná zmeny, funkcia 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. Funkcie SubmitForm a ResetForm nemajú v tomto režime ž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):

Režim	DisplayMode	Popis
FormMode.Edit	DisplayMode.Edit	Údajové karty a ovládacie prvky sa dajú upravovať, je možné urobiť zmeny v zázname.
FormMode.New	DisplayMode.Edit	Údajové karty a ovládacie prvky sa dajú upravovať, je možné vytvoriť nový záznam.
FormMode.View	DisplayMode.View	Údajové karty a ovládacie prvky sa nedajú upravovať, sú optimalizované na zobrazenie.

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:

   SubmitFormTento článok sa uvádza v článku 2 EditForm

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

   späť()

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

   EditForm. Chyba

   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. ErrorText je prázdny a znova sa zobrazí 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:

   ResetFormV článku 2 ods. EditForm Spätný()

   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:

   NewFormV článku 2 ods. 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. SubmitForm Pri spustení funkcie sa záznam nevytvorí a neaktualizuje.