Partekatu honen bidez:


EditForm, NewForm, SubmitForm, ResetForm eta ViewForm funtzioak

Honi dagokio: Canvas aplikazioei

Ikusi, editatu edo sortu elementua, gorde edukia eta berrezarri kontrol batean Edit form kontrola.

Informazio orokorra

Funtzio horiek aldatu egiten dute egoera Edit form kontrola. Inprimakiaren kontrola modu hauetako batean egon daiteke:

Modua Deskribapenak
FormMode.Edit Inprimakia lehendik dagoen erregistro batekin dago eta erabiltzaileak eremuen balioak alda ditzake. Behin amaituta, erabiltzaileak erregistroan aldaketak gorde ditzake.
FormMode.New Inprimakia balio lehenetsiekin betetzen da eta erabiltzaileak eremuen balioak alda ditzake. Behin amaituta, erabiltzaileak gehitu egin dezake erregistroa datu-iturburura.
FormMode.View Inprimakia lehendik dagoen erregistro batekin dago baina erabiltzaileak eremuen balioak ezin du aldatu.

Deskribapenak

Funtzio hauek sarritan deitzen dira OnSelect a Button edo Irudia kontrolatu, erabiltzaileak aldaketak gorde, aldaketak utzi edo erregistro bat sor dezan. Ahal duzu erabili kontrolak eta funtzio horiek batera konponbide osatua sortzeko.

Funtzio hauek ez dute baliorik.

Funtzio horiek barruan bakarrik erabil ditzakezu portaera-formuletan.

SubmitForm

Erabili SubmitForm funtzioan OnSelect botoia kontrol baten jabetza datu-iturburu-en inprimaki kontrol batean egindako aldaketa guztiak gordetzeko.

Aldaketarik bidali baino lehen, funtzio honek baliozkotasuneko arazoak behar ditu, beharrezkotzat markatutako eremu batekin edo bere balioarekiko murrizketa bat edo gehiago dituena. Jokabide honek bat egiten du Balidatu funtzioa.

SubmitForm Inprimakiaren Valid propietatea ere egiaztatzen du, hau da, Valid guztien batuketa. Inprimaki kontrolak dituen #glsr_cfighfdez kontrolen propietateak. Arazoren bat gertatzen bada, datuak ez dira aurkeztuko eta Akatsa eta ErrorKind Inprimaki kontrolaren propietateak horren arabera finkatzen dira.

Balidazioa pasatzen bada, SubmitForm aldaketa bidali du datu-iturburu-ri.

  • Arrakasta bada, formularioaren OnSuccess portaera exekutatuko da eta Error eta ErrorKind propietateak garbitu egiten dira. Inprimakia sartu bazen FormMode.New modua da FormMode.Edit era.
  • Arrakastarik ez badu, Formularioaren OnFailure portaera exekutatuko da eta Error eta ErrorKind propietateak horren arabera ezartzen dira. Inprimakiaren modua aldatu gabe dago.

EditForm

EditForm funtzioak Inprimakiaren kontrol modua aldatzen du FormMode.Edit. Modu honetan Inprimakiaren kontrolaren edukia Elementua ondasunak inprimakia betetzeko erabiltzen dira. Bada SubmitForm funtzioa inprimakia modu honetan exekutatzen da, erregistro bat aldatu, ez da sortu. FormMode.Edit Inprimaki kontrolerako lehenetsia da.

Oharra

Inprimakia editatze modu-en dagoenean eta Elementua nulua denean, txartela-en propietateak ez dira ebaluatzen eta balio lehenetsiak itzuliko dituzte.

NewForm

NewForm funtzioak Inprimakiaren kontrol modua aldatzen du FormMode.New. Modu honetan Inprimakiaren kontrolaren edukia Elementua propietateak ez dira aintzat hartzen eta inprimakiaren balio lehenetsiak Datu-iturburua ondasunek inprimakia populatzen dute. Bada SubmitForm funtzioa inprimakia modu honetan exekutatzen da, erregistro bat sortu, ez da aldatu.

ResetForm

ResetForm funtzioak inprimaki baten edukia hasierako balioetara berresten du, erabiltzaileak aldaketarik egin aurretik. Inprimakia sartu bazen FormMode.New modua inprimakia da berrezartzeko FormMode.Edit era. OnReset inprimaki kontrolaren portaerak ere exekutatzen du. Bakoitzak kontrolak berrezarri ditzakezu Reset funtzioa baina forma barrutik soilik.

ViewForm

ViewForm funtzioak Inprimakiaren kontrol modua aldatzen du FormMode.View. Modu honetan Inprimakiaren kontrolaren edukia Elementua ondasunak inprimakia betetzeko erabiltzen dira. SubmitForm eta ResetForm funtzioek ez dute eraginik modu honetan.

DisplayMode Propietatea

Uneko modua irakur daiteke Era Jabetza. Moduak ere zehazten du balioa DisplayMode inprimaki kontrolaren barruan datu txartelak eta kontrolak erabil ditzaketen propietateak. Sarritan, datu txartelarena da DisplayMode ondasunak ezarriko dira Parent.DisplayMode (inprimakia erreferentziatuta) kontrolak bezala egingo du DisplayMode jabetza (datu-txartela erreferentzia hartuta):

Modua DisplayMode Deskribapenak
FormMode.Edit DisplayMode.Edit Datu-txartelak eta kontrolak editagarriak dira, erregistro batean aldaketak onartzeko prest.
FormMode.New DisplayMode.Edit Datu-txartelak eta kontrolak editagarriak dira, erregistro berria onartzeko prest.
FormMode.View DisplayMode.View Datu-txartelak eta kontrolak ez dira editatzeko eta optimizatzeko ikusteko.

Sintaxia

SubmitForm( FormName )

  • FormName - Beharrezkoa. datu-iturburu-era bidaltzeko inprimakiaren kontrola.

EditForm( FormName )

  • FormName - Beharrezkoa. Formularioaren kontrola FormMode.Edit era.

NewForm( FormName )

  • FormName - Beharrezkoa. Formularioaren kontrola FormMode.New era.

ResetForm( FormName )

  • FormName - Beharrezkoa. Inprimaki kontrola hasierako balioetara berrezarri ahal izateko. Inprimakia ere aldatu egiten du FormMode.New modua FormMode.Edit modua.

ViewForm( FormName )

  • FormName - Beharrezkoa. Formularioaren kontrola FormMode.View era.

Adibideak

Ikusi Ulertu datuen inprimakia adibide osoetarako.

  1. Gehitu botoiaren kontrola, ezarri horren Testua propietatea erakusteko Gorde, eta ezarri horren OnSelect propietatea formula honetan:

    SubmitForm( EditForm )

  2. Ezar ezazu OnFailure Inprimaki kontrol baten propietatea hutsik eta haren hutsarekin OnSuccess formula honen jabetza:

    Back()

  3. Izendu Label kontrola ErrorText, eta ezarri horren Testua propietatea formula honetan:

    EditForm.Error

    Erabiltzaileak aukeratzen duenean Gorde botoian, inprimakiaren kontrolean aldaketak azpiko datu-iturburu bidaltzen dira.

    • Bidalketa arrakastatsua izanez gero, aldaketa guztiak gordeko dira edo, inprimakiaren kontrola badago Berria moduan, erregistro bat sortzen da. ErrorText dago hutsik eta aurreko pantaila berriro agertuko da.
    • Bidalketa huts egiten badu, ErrorText Erabiltzaileekiko errore-mezu bat erakusten du eta uneko pantaila ikusgai egongo da erabiltzaileak arazoa zuzendu dezan eta berriro saiatu dadin.
  4. Gehitu botoiaren kontrola, ezarri horren Testua propietatea erakusteko Ezeztatu, eta ezarri horren OnSelect propietatea formula honetan:

    ResetForm( EditForm ); Atzera()

    Erabiltzaileak aukeratzen duenean Utzi botoian, inprimakiaren kontroleko balioak erabiltzailea editatzen hasi aurretik zeuden berrezarriko dira, aurreko pantaila berriro agertuko da eta inprimakiaren kontrola berriro Editatu modua sartu bazen Berria era.

  5. Gehitu botoiaren kontrola, ezarri horren Testua propietatea erakusteko Berria, eta ezarri horren OnSelect propietatea formula honetan:

    NewForm( EditForm ); Navigate( EditScreen, None )

    Erabiltzaileak aukeratzen duenean Berria botoia, Form kontrol kontrola Berria modua, Forma kontrolaren datu-iturburu-en balio lehenetsiak kontrol hori betetzen du eta Inprimakiaren kontrola daukan pantaila agertuko da. Noiz SubmitForm funtzioa exekutatzen da, erregistro bat sortzen da eguneratu beharrean.