EditForm, NewForm, SubmitForm, ResetForm és ViewForm függvények
A következőkre vonatkozik:
Vászonalapú alkalmazások
Ezekkel a függvényekkel megtekintheti, szerkesztheti, illetve létrehozhatja a szerkesztési űrlap típusú vezérlők elemeit, mentheti a tartalmat és alaphelyzetbe állíthatja a vezérlőket.
Áttekintés
Ezek a függvények a szerkesztési űrlap típusú vezérlőelemek állapotát változtatják meg. Az űrlap-vezérlőelem az alábbi módok egyikében lehet:
| Üzemmód | Ismertetés |
|---|---|
| FormMode.Edit | Az űrlap egy létező rekorddal töltődik ki, a felhasználó pedig módosíthatja a mezők értékeit. Miután végzett, a felhasználó mentheti a rekordon végrehajtott változtatásokat. |
| FormMode.New | Az űrlap alapértelmezett értékekkel töltődik ki, a felhasználó pedig módosíthatja a mezők értékeit. Miután végzett, a felhasználó hozzáadhatja a rekordot az adatforráshoz. |
| FormMode.View | Az űrlap egy létező rekorddal töltődik ki, de a felhasználó nem módosíthatja a mezők értékeit. |
Ismertetés
Ezeket a függvényeket gyakran egy Gomb vagy Képvezérlőelem OnSelect képletéből hívják meg, így a felhasználó mentheti a módosításokat, megszakíthatja a szerkesztéseket, vagy rekordot hozhat létre. Teljes megoldás létrehozásához használja a vezérlőket ezekkel a függvényekkel.
Ezek a függvények nem adnak vissza értéket.
Ezek a függvények csak viselkedésszabályozó képletekben használható.
SubmitForm
Egy gomb típusú vezérlő OnSelect tulajdonságán belüli SubmitForm függvény használatával egy űrlap-vezérlőelem minden változása menthető az adatforrásba.
A módosítások véglegesítése előtt a függvény elvégzi a kötelezőként megjelölt, illetve egy vagy több, értékre vonatkozó megkötéssel rendelkező mezők ellenőrzését. Ez a viselkedés megegyezik a Validate függvényével.
A SubmitForm ellenőrzi az űrlap Érvényes tulajdonságát is, amely az Űrlap vezérlőelemben található vezérlőelem kártya ek összes Érvényes tulajdonságának összesítése. Probléma esetén a rendszer nem küldi el az adatokat, és az űrlap-vezérlőelem Error és ErrorKind tulajdonsága felveszi a megfelelő értéket.
Ha az ellenőrzés nem talál problémát, a SubmitForm függvény elküldi a módosításokat az adatforrásnak.
- Ha sikeres, az űrlap OnSuccess viselkedése lefut, és az Error és az ErrorKind tulajdonságok törlődnek. Ha az űrlap FormMode.New módban volt, akkor visszaáll FormMode.Edit módba.
- Ha sikertelen, az űrlap OnFailure viselkedése lefut, és az Error és az ErrorKind tulajdonságok ennek megfelelően vannak beállítva. Az űrlap módja változatlan marad.
EditForm
Az EditForm függvény FormMode.Edit módba állítja át az űrlap-vezérlőelemet. Ebben a módban az űrlap az űrlap-vezérlőelem Item tulajdonságának tartalma alapján töltődik ki. Ha a SubmitForm függvény akkor fut, amikor az űrlap ilyen módban van, akkor nem létrejön rekord, hanem módosul. A FormMode.Edit az űrlap-vezérlőelem alapértelmezett beállítása.
Feljegyzés
Ha az űrlap szerkesztőmód és az Elem értéke null, a rendszer nem értékeli ki az adatokat kártya tulajdonságokat, és az alapértelmezett értékeket adja vissza.
NewForm
A NewForm függvény FormMode.New módba állítja át az űrlap-vezérlőelemet. Ebben a módban az űrlap-vezérlőelem Item tulajdonságát figyelmen kívül hagyja a rendszer, és az űrlap a DataSource tulajdonság alapértelmezett értékei alapján lesz kitöltve. Ha a SubmitForm függvény akkor fut, amikor az űrlap ilyen módban van, akkor nem módosul egy rekord, hanem létrejön.
ResetForm
A ResetForm függvény a felhasználó által végzett módosítások előtti eredeti értékekre állítja vissza egy űrlap tartalmát. Ha az űrlap FormMode.New módban van, akkor visszaáll FormMode.Edit módba. Lefut az űrlap-vezérlőelem OnReset művelete is. Az egyes vezérlők a Reset függvénnyel is visszaállíthatók, de csak az űrlapon belülről.
ViewForm
A ViewForm függvény FormMode.View módba állítja át az űrlap-vezérlőelemet. Ebben a módban az űrlap az űrlap-vezérlőelem Item tulajdonságának tartalma alapján töltődik ki. A SubmitForm és a ResetForm függvénynek ebben a módban nincs hatása.
A DisplayMode tulajdonság
Az aktuális mód a Mode tulajdonságból olvasható ki. A mód meghatározza a DisplayMode (Megjelenési mód) tulajdonság értékét is, amelyet adatkártyák és vezérlők használhatnak az űrlap-vezérlőelemen belül. Az adatkártya DisplayMode tulajdonsága gyakran a Parent.DisplayMode értékre lesz beállítva (az űrlapra hivatkozva), akárcsak a vezérlő DisplayMode tulajdonsága (az adatkártyára hivatkozva):
| Üzemmód | DisplayMode | Ismertetés |
|---|---|---|
| FormMode.Edit | DisplayMode.Edit | Az adatkártyák és a vezérlők szerkeszthetők, és készen állnak a rekordok módosításainak elfogadására. |
| FormMode.New | DisplayMode.Edit | Az adatkártyák és a vezérlők szerkeszthetők, és készen állnak új rekordok fogadására. |
| FormMode.View | DisplayMode.View | Az adatkártyák és a vezérlők nem szerkeszthetők, és megtekintésre vannak optimalizálva. |
Szintaxis
SubmitForm( űrlapnév )
- FormName - Kötelező. Űrlap-vezérlőelem az adatforrásba való beküldéshez.
EditForm( űrlapnév )
- FormName - Kötelező. Űrlap-vezérlőelem a FormMode.Edit módba váltáshoz.
NewForm( FormName )
- FormName - Kötelező. Űrlap-vezérlőelem a FormMode.New módba váltáshoz.
ResetForm( FormName )
- FormName - Kötelező. Űrlap-vezérlőelem a kezdőértékek visszaállításához. Az űrlapot FormMode.New módból FormMode.Edit módba is átállítja.
ViewForm( űrlapnév )
- FormName - Kötelező. Űrlap-vezérlőelem a FormMode.View módba váltáshoz.
Példák
Teljes példákat az Adatűrlapok ismertetése című cikk tartalmaz.
Vegyen fel egy gomb típusú vezérlőt, állítsa a Text tulajdonságát Mentés értékre, és az OnSelect tulajdonsága értékeként adja meg ezt a képletet:
SubmitForm( EditForm )
Állítsa egy űrlap-vezérlőelem OnFailure tulajdonságát üresre, az OnSuccess tulajdonsága értékeként pedig adja meg ezt a képletet:
Vissza()
Vegyen fel egy Hibaüzenet nevű Címke típusú vezérlőelemet, majd a Text tulajdonsága értékeként adja meg ezt a képletet:
EditForm.Error
Amikor a felhasználó a Mentés gombra kattint, a rendszer az űrlap-vezérlőelem összes módosítását elküldi az alapul szolgáló adatforrásba.
- Ha a küldés sikeres, akkor a változásokat menti a rendszer, vagy – ha az űrlap-vezérlőelem New módban van – létrejön egy új rekord. Az ErrorText üres , és az előző képernyő újra megjelenik.
- Ha a küldés sikertelen, akkor az ErrorText egy felhasználóbarát hibaüzenetet jelenít meg, és az aktuális képernyő marad látható, hogy a felhasználó kijavíthassa a hibát, majd újrapróbálkozhasson.
Vegyen fel egy gomb típusú vezérlőt, állítsa annak Text tulajdonságát Mégse értékre, és az OnSelect tulajdonsága értékeként adja meg ezt a képletet:
ResetForm( EditForm ); Vissza()
Amikor a felhasználó a Mégse gombra kattint, az űrlap-vezérlőelem értékei visszaállnak a felhasználó által végzett módosítások előtti értékre, megjelenik az előző képernyő, az űrlap-vezérlőelem pedig visszatér Edit módba, ha New módban volt.
Vegyen fel egy gomb típusú vezérlőt, állítsa a Text tulajdonságát Új értékre, és az OnSelect tulajdonsága értékeként adja meg ezt a képletet:
NewForm( EditForm ); Navigálás( EditScreen, Nincs )
Amikor a felhasználó az Új gombra kattint, az űrlap-vezérlőelem New módba vált, a vezérlő az űrlap-vezérlőelem adatforrásának alapértelmezett értékeivel lesz kitöltve, és megjelenik az űrlap-vezérlőelemet tartalmazó képernyő. Ha a SubmitForm függvény lefut, akkor nem frissül, hanem létrejön egy rekord.