Tapahtumakäsittelijän luominen

Huomautus: Microsoft haluaa tarjota sinulle ajantasaisinta ohjesisältöä mahdollisimman nopeasti omalla kielelläsi. Tämä sivu on käännetty automaation avulla, ja siinä saattaa olla kielioppivirheitä tai epätarkkuuksia. Tarkoitus on, että sisällöstä on sinulle hyötyä. Kertoisitko sivun alareunassa olevan toiminnon avulla, oliko tiedoista hyötyä? Tästä pääset helposti artikkelin englanninkieliseen versioon.

Kun kirjoitat komentosarjaa Microsoft Office InfoPath-lomakemalliksi kirjoitat koodia tavallisesti jossakin lomakkeen mallin tai tietojen kelpoisuuden tarkistaminen tapahtumien käsittely. Tapahtumakäsittelijä on InfoPath-lomakemalliksi, joka vastaa käyttäjän toimet tai lomakkeen XML-tietojen muuttaminen. Tapahtumakäsittelijän luominen riippuu siitä, jota haluat käyttää tapahtuman tyyppi. On tärkeää luoda tapahtumakäsittelijä suunnittelutilassa, koska InfoPath luo tapahtumien käsittely-komentosarjatiedosto ja tekee merkintöjä (.xsf) Lomakemääritystiedosto, joka käyttää näiden tapahtumien käsittely lomakemallin ottaminen käyttöön automaattisesti.

Huomautus: Se on mahdollista, voit luoda tapahtuman käsittelytoimintoja manuaalisesti komentosarjatiedosto ja otat ne manuaalisesti lisäämällä asianmukaisia elementtejä .xsf-tiedoston, mutta se ei suositella. Jos virheellinen muutetaan .xsf-tiedostoon, lomakemallin ei ehkä ole käytettävissä.

Seuraavassa taulukossa luetellaan kunkin InfoPath tapahtuman tiedostokäsittelijöitä ja niiden luomisen vaiheet. Kun luot tapahtumakäsittelijän lomakemallin, InfoPath käynnistää Microsoft Script Editor (MSE) ja siirtää kohdistimen kyseisen tapahtumakäsittelijän koodiin. Voit kirjoittaa komentosarja tapahtumakäsittelijän. Saat lisätietoja InfoPath-tapahtumien ja tapahtumien käsittely InfoPath-Sovelluskehittäjän opas, joka on käytettävissä ohjeaiheista.

Tapahtumakäsittelijä

Kuvaus

Luomisen vaiheet

OnAfterChange

Tapahtuman suoritetaan, kun käyttäjä muuttaa sidottu kenttään ohjausobjektin arvon. Voit esimerkiksi näyttää mukautettu HTML-tehtäväruutu sen jälkeen, kun käyttäjä valitsee kohteen luetteloruutu. Tapahtuman suorittaa OnValidate tapahtuman jälkeen.

Lomakemallin tai kentän Tietolähde -tehtäväruudun ohjausobjektia hiiren kakkospainikkeella, osoita Ohjelmointi pikavalikosta ja valitse sitten Valitse sen jälkeen muuta tapahtuma.

OnAfterImport

Tapahtuman suoritetaan, kun käyttäjä onnistuneesti yhdistää useita lomakkeita yhteen lomakkeeseen.

Manuaalisesti lisätä OnAfterImport tapahtumakäsittelijän määritelmään komentosarjatiedosto MSE avulla. Tämä tapahtumakäsittely ei voi luoda suunnittelutilassa.

OnBeforeChange

Tapahtuman suoritetaan käyttäjän ohjausobjektin arvon muuttamisen jälkeen ja ennen kuin arvo lisätään määritetyn kentän sidottu ohjausobjekti. Voit esimerkiksi estää käyttäjän lisäämästä Lisää rivi ennen täyttämistä viimeisen rivin toistuva taulukko.

Lomakemallin tai kentän Tietolähde -tehtäväruudun ohjausobjektia hiiren kakkospainikkeella, osoita Ohjelmointi pikavalikosta ja valitse sitten Valitse ennen muuta tapahtuman.

Napsautettaessa

Tapahtuman suoritetaan, kun käyttäjä napsauttaa tapahtuman liittyvä painike. Tapahtuman on käytettävissä, kun olet lisännyt painikkeen lomakemalliin. Voit esimerkiksi suorittaa monimutkaisia laskutoimituksen käyttämällä arvot kenttien tärkeimmät tietolähteen käyttäjän napsauttaessa painiketta.

Kaksoisnapsauta painikkeen ohjausobjektia ja valitse sitten Ominaisuudet -valintaikkunan Yleiset -välilehdessä Muokkaa lomakkeen koodia.

OnContextChange

Tapahtuman suoritetaan, kun kohdistin muuttuu lomakkeessa. Esimerkiksi tapahtuman suoritetaan, kun käyttäjä siirtyy muokkausruudun päivämäärävalitsimen tai kun käyttäjä vaihtaa näkymiä. Tapahtuman tapahtuu, kun muita tapahtumia on tapahtunut.

Valitse Työkalut -valikosta Ohjelmointija valitse sitten Kontekstin muuta tapahtuma.

OnLoad

Tapahtuman suoritetaan aina, kun käyttäjä luo uuden lomakkeen tai avaa aiemmin luodun lomakkeen lomakemallin perusteella. Esimerkiksi voit kopioida kohteiden luettelo toissijainen tietolähteestä tärkeimmät tietolähteeseen kun käyttäjä avaa lomakkeen.

Valitse Työkalut -valikosta Ohjelmointija valitse sitten Tapahtuma kuormituksen.

OnMergeRequest

Tapahtuman suoritetaan, kun lomakemalliin perustuvien lomakkeiden yhdistetään. Voit esimerkiksi näyttää lomakkeita, joilla voit antaa käyttäjän tila yhdistämisen aikana yhdistämällä määrä.

Valitse Työkalut -valikosta Lomakeasetukset. Valitse luokka -luettelosta valitsemalla Lisäasetukset. Valitse Yhdistä lomakkeetYhdistä käyttäen mukautettua koodia -valintaruutu ja valitse sitten Muokkaa.

OnSaveRequest

Tapahtuman suoritetaan, kun käyttäjä tallentaa lomakemalliin perustuvan lomakkeen. Voit esimerkiksi tallentaa perusteella tämän lomakemallin useammassa kuin yhdessä paikassa, kun käyttäjä tallentaa lomakkeen lomake. InfoPath lisää kaksi Lisää rivejä-koodin tapahtuman: rivi, joka tallentaa lomakkeen ja toinen rivi, joka ilmoittaa, jos InfoPath tallennettiin lomakkeen.

Valitse Työkalut -valikosta Lomakeasetukset. Valitse luokka -luettelosta avaaminen ja tallentaminen. Valitse Tallenna toimintaValitse Tallenna käyttäen mukautettua koodia -valintaruutu ja valitse sitten Muokkaa.

OnSign

Tapahtuman suoritetaan, kun käyttäjä koskee digitaalisen allekirjoituksen lisääminen lomakkeeseen. Voit esimerkiksi lisätä tiedot kuluraporttilomakkeen digitaalisen allekirjoituksen käyttäjän kirjautuessa sitä.

Valitse Työkalut -valikosta Ohjelmointija valitse sitten Tapahtuma merkki.

OnSubmitRequest

Tapahtuman suoritetaan, kun käyttäjä lähettää yhteystietoluetteloonsa lomakkeen tiedot. Voit esimerkiksi lähettää suojatun verkkopalvelun lomakkeen tiedot käyttäjän napsauttaessa LähetäTiedosto -valikosta. InfoPath ei tue tietoyhteyden suojatun Web-palveluun, koska haluat lisätä mukautetun tietoyhteyden, joka toimii suojatun WWW-palvelun kanssa.

Valitse Työkalut -valikosta Lähetysasetukset. Käyttäjät voivat lähettää tämä valintaruutu, valitse Suorita mukautettu toiminto-koodin avullaja valitse sitten Muokkaa koodia.

OnSwitchView

Tapahtuman suoritetaan, kun käyttäjä avaa lomakemalliin perustuvan lomakkeen tai siirtää toiseen näkymään lomakkeessa. Kun käyttäjä vaihtaa tietyn, voit luoda sähköpostiviestin, joka sisältää tiedot-lomakkeen tietolähteeksi-kentistä.

Työkalut -valikon Valitse Ohjelmointija valitse sitten Vaihda Näytä tapahtuma.

OnValidate

Tapahtuman suoritetaan, kun käyttäjä vaihtaa kentän sidottu ohjausobjekti arvon. Esimerkiksi kun käyttäjä muuttaa tietyn ohjausobjektin arvon, voit laskea toiseen ohjausobjektiin uusi arvo käyttäjän syöttämät numero ja luku, joka on komentosarjan avulla. Tapahtuman tapahtuu, kun OnBeforeChange tapahtumakäsittelijä suoritetaan.

Lomakemallin tai kentän Tietolähde -tehtäväruudun ohjausobjektia hiiren kakkospainikkeella ja valitse pikavalikosta Ohjelmointi-Kun Validate tapahtuman.

OnVersionUpgrade

Tapahtuman suoritetaan, kun käyttäjä avaa olemassa olevaa lomaketta ja käyttää olemassa olevaa lomaketta lomakemallin versionumero on vanhempi kuin lomakemallin julkaiseminen sijainnissa versionumero. Kun käyttäjä avaa aiemmin luodun lomakkeen, InfoPath tarkistaa liittyvät aiemmin luodun lomakkeen lomakemallin versionumero. Jos lomakemalli on uudempi versionumero, InfoPath suorittaa OnVersion tapahtumakäsittelijä, kun käyttäjä avaa olemassa olevaa lomaketta. Oletetaan esimerkiksi, että uuden kentän lisääminen aiemmin luodun lomakemallin ja julkaista sen uudelleen, ja haluat uuden kentän, joka lisätään tärkeimmät tietolähteen, jos käyttäjä avaa aiemmin luodun lomakkeen. Tapahtuman Lisää uusi kenttä tärkeimmät tietolähteeseen, kun käyttäjä avaa aiemmin luodun lomakkeen.

Valitse Työkalut -valikosta Lomakeasetukset. Valitse luokka -luettelosta Versiotietojen. Versio päivitetään -luettelossa Käytä mukautettua tapahtumaaja valitse sitten Muokkaa.

Kehitä Office-taitojasi
Tutustu koulutusmateriaaliin
Saat uudet ominaisuudet ensimmäisten joukossa
Liity Office Insider -käyttäjiin

Oliko näistä tiedoista hyötyä?

Kiitos palautteesta!

Kiitos palautteestasi! Näyttää siltä, että Office-tukiedustajamme avusta voi olla sinulle hyötyä.

×