EditForm, NewForm, SubmitForm, ResetForm és ViewForm függvények

  • Cikk

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ó Kártya vezérlőelemek ö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 módja.

Feljegyzés

Ha az űrlap szerkesztőmód és az Elem értéke null, a rendszer nem értékeli ki az adatká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 )

  • ŰrlapNév – Kötelező. Űrlap-vezérlőelem az adatforrásba való beküldéshez.

EditForm( ŰrlapNév )

  • ŰrlapNév – Kötelező. Űrlap-vezérlőelem a FormMode.Edit módba váltáshoz.

NewForm( ŰrlapNév )

  • ŰrlapNév – Kötelező. Űrlap-vezérlőelem a FormMode.New módba váltáshoz.

ResetForm( ŰrlapNév )

  • ŰrlapNév – 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 )

  • ŰrlapNév – 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.

  1. 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 )

  2. Á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:

    Back()

  3. 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 újra megjelenik az előző képernyő.
    • 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.

  4. 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 ); Back()

    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.

  5. 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 ); Navigate( EditScreen, None )

    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.