Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
Lomakkeiden ja ruudukoiden tapahtumat käynnistävät kaikki asiakaspuolen koodit mallipohjaisissa sovelluksissa. Liität tietyn funktion JavaScript-kirjastoon (Komentosarjan verkkoresurssi), joka suoritetaan, kun tapahtuma ilmenee. Tätä funktiota kutsutaan tapahtumakäsittelijäksi. Jokainen tapahtumakäsittelijä määrittää javaScript-kirjastossa yhden funktion sekä funktiolle välitettävät parametrit.
Voit liittää tapahtumakäsittelijöitä vain joihinkin tapahtumiin käyttöliittymän avulla. Asiakasohjelman ohjelmointirajapinta tarjoaa tapahtumia, joita ei voi liittää käyttöliittymän kautta, menetelmiä, joilla voit liittää tapahtumakäsittelijöitä.
Tapahtumakäsittelijän funktioiden lisääminen tai poistaminen lomakkeissa käyttöliittymän avulla
Voit lisätä tai poistaa tapahtumakäsittelijän funktioita uuden Unified Interfacen tapahtumiin seuraavasti:
Siirry kohteeseen Power Apps.
Valitse vasemmassa siirtymisruudussa Tiedot ja valitse sitten Taulukot.
Valitse taulukkoluettelosta taulukko, johon haluat lisätä tapahtumakäsittelijät.
Valitse Lomakkeet-välilehti komentopalkista ja valitse sitten lomake, johon haluat lisätä tapahtumakäsittelijän.
Valitse Tapahtumat-välilehti . Näet sekä Tallennuksen että Käytössä olevan kuormituksen tapahtumakäsittelijät.
Jos haluat lisätä tapahtumakäsittelijän muutostapahtumalle, valitse sarake ja valitse sitten Tapahtuma-välilehti .
Lomakkeiden joukkomuokkaus
Oletusarvoisesti tapahtumakäsittelijöitä ei suoriteta, kun lomake on joukkomuokkaustilassa.
Jos haluat ottaa tapahtumakäsittelijän käyttöön joukkomuokkaustilassa, muokkaa lomakkeen XML-tiedostoa etsimällä asianmukainen event elementti ja luomalla tai määrittämällä määritteen BehaviorInBulkEditForm arvoksi Enabled. Tällä hetkellä tätä toimintoa tuetaan vain OnLoad-tapahtumissa.
Jos haluat lisätietoja lomakkeen XML-mukauttamisesta, katso Milloin muokata mukautustiedostoa, Mukauta lomakkeita ja Lomakkeen XML-rakenne.
Voit selvittää, milloin tapahtumakäsittelijä suoritetaan lomakkeessa joukkomuokkaustilassa, käyttämällä - getFormType menetelmää.
Tapahtumakäsittelijän funktioiden lisääminen tai poistaminen asiakkaan ohjelmointirajapinnan koodin avulla
Seuraavien menetelmien avulla voit lisätä ja poistaa tapahtumakäsittelijöitä tapahtumista, joita ei voi liittää käyttöliittymän kautta:
| Tapahtumia | Tapahtumakäsittelijä |
|---|---|
| Määritteen OnChange | addOnChange- ja removeOnChange-menetelmät |
| Lomakkeen onLoad | formContext.ui addOnLoad ja removeOnLoad menetelmät |
| Lomake ladattu | formContext.ui addLoaded ja removeLoaded-menetelmät |
| Lomaketietojen OnLoad | formContext.data addOnLoad ja removeOnLoad menetelmät |
| Lomakkeen Tallennukset | addOnSave- ja removeOnSave-menetelmät |
| Hakuohjausobjekti PreSearch | addPreSearch ja removePreSearch-menetelmät |
| kbsearch-ohjausobjekti OnResultOpened | addOnResultOpened ja removeOnResultOpened-menetelmät |
| kbsearch-ohjausobjekti OnSelection | addOnSelection- ja removeOnSelection-menetelmät |
| kbsearch-ohjausobjekti PostSearch | addOnPostSearch- ja removeOnPostSearch-menetelmät |
Tärkeää
Suorituskonteksti välitetään automaattisesti ensimmäisenä parametrina funktioille, jotka määrität koodin avulla. Lisätietoja on kohdassa Asiakkaan ohjelmointirajapinnan suorituskonteksti.
Lomakkeen tapahtumaputki
Voit määrittää enintään 50 tapahtumakäsittelijää kullekin tapahtumalle. Lomakkeen ominaisuudet -valintaikkunan Tapahtumat-välilehdenTapahtumakäsittelijät-osiossa näytetään tapahtumakäsittelijöiden järjestys ja kunkin tapahtumakäsittelijän suorittamisjärjestys tässä järjestyksessä.
Käytä setSharedVariable - ja getSharedVariable-menetelmiä yleisen muuttujan välittämiseen tapahtumakäsittelijöiden (funktioiden) välillä. Suorituskontekstin getDepth-menetelmän avulla voit ymmärtää tapahtumakäsittelijän suorituksen järjestyksen suhteessa muihin tapahtumakäsittelijöihin.
Liittyvät artikkelit
Asiakkaan ohjelmointirajapinnan objektimallin ymmärtäminen
Asiakkaan ohjelmointirajapinnan suorituskonteksti
Tapahtumat (asiakasohjelman ohjelmointirajapinnan viittaus)