Mallipohjaisten sovellusten lomakkeiden ja ruudukoiden tapahtumat

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:

  1. Siirry kohteeseen Power Apps.

  2. Valitse vasemmassa siirtymisruudussa Tiedot ja valitse sitten Taulukot.

  3. Valitse taulukkoluettelosta taulukko, johon haluat lisätä tapahtumakäsittelijät.

  4. Valitse Lomakkeet-välilehti komentopalkista ja valitse sitten lomake, johon haluat lisätä tapahtumakäsittelijän.

    Lomakkeet-välilehden näyttökuva, joka näyttää taulukon lomakeluettelon Power Apps.

  5. Valitse Tapahtumat-välilehti . Näet sekä Tallennuksen että Käytössä olevan kuormituksen tapahtumakäsittelijät.

    Näyttökuva Tapahtumat-välilehdestä, jossa näkyvät On Save- ja On Load -lomakkeen tapahtumakäsittelijät.

  6. Jos haluat lisätä tapahtumakäsittelijän muutostapahtumalle, valitse sarake ja valitse sitten Tapahtuma-välilehti .

    Näyttökuva Sarakkeen Tapahtumat-välilehdestä, joka näyttää On Change -tapahtumakäsittelijän asetukset.

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.

Asiakkaan ohjelmointirajapinnan objektimallin ymmärtäminen
Asiakkaan ohjelmointirajapinnan suorituskonteksti
Tapahtumat (asiakasohjelman ohjelmointirajapinnan viittaus)

  • Viimeksi päivitetty