Funkcie EditForm, NewForm, SubmitForm, ResetForm a ViewForm
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
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 karta ovládacích prvkov, 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 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 spustí funkcia SubmitForm v prípade formulára v tomto režime, záznam sa nevytvorí, ale zmení. 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 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):
| 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
OdoslaťFormulár( Názov formulára )
- FormName – povinné. Ovládací prvok formulára na odoslanie do zdroja údajov.
Upraviť formulár( Názov formulára )
- FormName – povinné. Ovládací prvok formulára na prepnutie do režimu FormMode.Edit.
Nový Formulár( Názov formulára )
- 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.
Zobraziť formulár( Názov formulára )
- 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.
Pridajte ovládací prvok Tlačidlo, nastavte jeho vlastnosť Text na hodnotu Save a nastavte jeho vlastnosť OnSelect na tento vzorec:
SubmitForm (EditForm)
Nastavte vlastnosť OnFailure ovládacieho prvku Formulár na prázdnu hodnotu a jeho vlastnosť OnSuccess na tento vzorec:
späť()
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. 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ť.
Pridajte ovládací prvok Tlačidlo, nastavte jeho vlastnosť Text na Cancel a vlastnosť OnSelect nastavte na tento vzorec:
ResetForm ( EditForm ); späť()
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.
Pridajte ovládací prvok Tlačidlo, nastavte jeho vlastnosť Text na hodnotu New a nastavte jeho vlastnosť OnSelect na tento vzorec:
NewForm( EditForm ); Navigovať (Upraviť obrazovku, Žiadne)
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ý.