Power Fx -muuttujat

Muistiinpano

Microsoft Power Fx on pohjaan perustuvien sovellusten kaavakielen uusi nimi. Näitä artikkeleita käsitellään parhaillaan, kun Microsoft poimii kielen pohjaan perustuvista sovelluksista, integroi sen muihin Microsoft Power Platform tuotteisiin ja tuo sen saataville avoin lähdekoodi. Kieleen tutustuminen kannattaa aloittaa lukemalla Microsoft Power Fx:n yleiskatsaus.

Lue, miten Power Fx -muuttujat eroavat muuttujista eri työkaluissa, kuten Visual Basic tai JavaScriptissä, ja milloin kaavat ovat parempi vaihtoehto. Tässä artikkelissa kerrotaan, miten voit valita yleisiä muuttujia, kontekstimuuttujia tai kokoelmia sovellusarvojen ja tilan hallitsemiseksi.

Muissa työkaluissa voit suorittaa laskutoimituksen ja tallentaa tuloksen muuttujaan. Power Fx ja Excel laskevat kuitenkin kaavat automaattisesti uudelleen syötetietojen muuttuessa, joten muuttujia ei yleensä tarvitse luoda ja päivittää. Noudattamalla tätä lähestymistapaa aina kun mahdollista, voit helpommin luoda, ymmärtää ja ylläpitää sovelluksia.

Joissakin tapauksissa sinun on käytettävä muuttujia Power Fx:ssä. Power Fx laajentaa Excel mallia lisäämällä toimintakaavoja. Nämä kaavat suoritetaan esimerkiksi silloin, kun käyttäjä valitsee painikkeen. Toimintakaavan sisällä on usein hyödyllistä määrittää muuttuja, jota käytetään muissa kaavoissa.

Yleensä kannattaa välttää muuttujien käyttämistä. Toisinaan kuitenkin vain muuttuja pystyy mahdollistamaan halutun ominaisuuden. Luot ja kirjoitat muuttujia implisiittisesti, kun ne näkyvät funktioissa, jotka määrittävät niiden arvot.

Excelin ja Power Fx:n vertailu

Excel

Muistellaan, miten Excel toimii. Solu voi sisältää arvon, kuten luvun tai merkkijonon, tai kaavan, joka perustuu muiden solujen arvoihin. Sen jälkeen, kun käyttäjä on lisännyt eri arvon soluun, Excel laskee automaattisesti uudestaan kaavat, jotka ovat riippuvaisia uudesta arvosta. Tätä varten ei tarvitse tehdä mitään ohjelmointia.

Seuraavassa esimerkissä soluun A3 on määritetty kaava A1+A2. Jos A1 tai A2 muuttuu, A3 lasketaan automaattisesti uudelleen muutosta vastaavaksi. Tämä toiminta ei edellytä koodausta kaavan ulkopuolella.

Näyttökuva Excel kaavasta, joka laskee summan uudelleen syötearvon muuttumisen jälkeen.

Excelissä ei ole muuttujia. Kaavan sisältävän solun arvo muuttuu siihen syötettyjen tietojen mukaan, mutta kaavan tulosta ei voi muistaa eikä tallentaa soluun tai minnekään muualle. Jos muutat solun arvoa, koko laskentataulukko saattaa muuttua ja mahdollisesti aiemmin lasketut arvot menetetään. Excel-käyttäjä voi kopioida ja liittää soluja, mutta tämä on käyttäjän manuaalisessa hallinnassa, eikä sitä ole mahdollista tehdä kaavoilla.

Power Fx

Power Fx:ssä luotava logiikka toimii paljolti samalla tavalla kuin Excel. Sen sijaan, että päivität solut, voit lisätä ohjausobjekteja mihin tahansa näytön kohtaan ja nimetä ne kaavoissa käyttämistä varten.

Power Appsissa voi esimerkiksi replikoida Excelin toiminnan sovelluksessa lisäämällä Selite-ohjausobjektin, jonka nimi on Label1, ja kaksi Tekstisyöte-ohjausobjektia, joiden nimet ovat TextInput1 ja TextInput2. Jos sitten asetat Label1:n Teksti-ominaisuudeksiTextInput1.Text + TextInput2.Text, se näyttää aina automaattisesti textInput1- ja TextInput2-lukujen summan.

Näyttökuva kahdesta tekstisyötteellä ja otsikosta, joka laskee summan Power Fx -kaavalla.

Huomaa, että kun Label1-ohjausobjekti on valittuna, sen Teksti-kaava näkyy kaavarivillä näytön yläreunassa. Täältä löydät kaavan TextInput1.Text + TextInput2.Text. Tämä kaava luo riippuvuussuhteen näiden ohjausobjektien välille, samalla tavalla kuin riippuvuuksia luodaan Excel-työkirjan solujen välille. Muutetaan TextInput1-arvoa:

Näyttökuva Power Fx -kaavasta, joka laskee summan automaattisesti uudelleen, kun syöte muuttuu.

Label1-kaava lasketaan automaattisesti uudelleen, ja uusi arvo näytetään.

Power Fx:ssä voidaan käyttää kaavoja määrittämään ohjausobjektin ensisijaisen arvon lisäksi myös ominaisuuksia, kuten muotoilun. Seuraavassa esimerkissä selitteen Väri-ominaisuuden kaava näyttää automaattisesti negatiiviset arvot punaisella. If-funktio näyttää tutulta Excelistä:

If( Value(Label1.Text) < 0, Color.Red, Color.Black )

Näyttökuva Power Fx -kaavasta, joka muuttaa otsikon väriä, kun laskettu arvo on negatiivinen.

Voit käyttää kaavoja moniin erilaisiin skenaarioihin:

  • Käyttämällä laitteen GPS:ää kartan ohjausobjekti voi näyttää nykyisen sijaintisi kaavalla, joka käyttää signaaleja Location.Latitude ja Location.Longitude. Kun siirryt, kartta seuraa sijaintiasi automaattisesti.
  • Muut käyttäjät voivat päivittää tietolähteitä. Muut ryhmän jäsenet voivat esimerkiksi päivittää SharePoint-luettelon kohteita. Kun päivität tietolähteen, riippuvaiset kaavat lasketaan automaattisesti uudelleen vastaamaan päivitettyjä tietoja. Jos viet esimerkkiä eteenpäin, voit määrittää valikoiman Items-ominaisuudeksi kaavan Filter( SharePointList ),, joka näyttää automaattisesti vastikään suodatetun tietuejoukon.

Power Fx -kaavojen edut

Sovellusten luominen kaavojen avulla tarjoaa monia etuja:

  • Jos tunnet Excelin, tunnet Power Fx:n. Malli ja kaavan kieli ovat samat.
  • Jos käytät muita ohjelmointityökaluja, harkitse, kuinka paljon koodia tarvitset näiden esimerkkien suorittamiseen. Visual Basicissa joutuisit kirjoittamaan tapahtumakäsittelijän muutostapahtumalle jokaiselle tekstinsyötteen ohjausobjektille. Koodi, joka suorittaa laskutoimituksen kussakin tapahtumakäsittelijässä, on ylimääräinen ja saattaa joutua vanhentumaan tai joutuisit kirjoittamaan yleisen aliohjelman. Power Fx:ssä tämä kaikki työ suoritetaan yhden rivin kaavalla.
  • Jotta ymmärtäisit, mistä Label1-teksti on peräisin, tiedät tarkalleen, mistä se tulee: kaava Text-ominaisuudessa . Tämän ohjausobjektin tekstiin ei voi vaikuttaa millään muulla tavalla. Perinteisessä ohjelmointityökalussa kaikki tapahtumakäsittelijät tai aliohjelmat voivat muuttaa nimen arvoa ohjelman missä tahansa kohdassa. Tämän lähestymistavan avulla voi olla vaikeaa seurata, milloin muuttujaa on muutettu ja missä sitä on muutettu.
  • Jos käyttäjä tekee muutoksen liukusäätimeen ja muuttaa sitten mieltään, liukusäädin on mahdollista palauttaa sen alkuperäiseen arvoon. Mitään muutosta ei ole mikään: sovellus näyttää samat ohjausobjektin arvot kuin ennenkin. Kokeiluista ja entä jos -testailuista ei ole seuraamuksia samalla tavalla kuin Excelissä.

Yleisesti ottaen, jos voit saavuttaa tehosteen käyttämällä kaavaa, se kannattaa. Anna Power Fx:n kaavamoduulin tehdä työ puolestasi.

Milloin muuttujia kannattaa käyttää

Muutetaan yksinkertainen lisäystoiminto siten, että se toimii kuin perinteinen laskin, joka näyttää juoksevan summan. Jos valitset Lisää-painikkeen , lisäät luvun juoksevan summan. Jos valitset Tyhjennä-painikkeen , palautat juoksevan summan nollaksi.

Näytä Kuvaus
Näyttökuva laskinsovelluksesta, jonka tekstisyötettä on syötetty nollalla ja 77. Kun sovellus käynnistyy, juokseva summa on 0.

Punainen piste tarkoittaa käyttäjän sormea tekstinsyöttöruudussa, jossa käyttäjä kirjoittaa 77.
Näyttökuva laskin, jonka tekstisyötteessä on 77, kun käyttäjä valitsee Lisää. Käyttäjä valitsee Lisää-painikkeen.
Näyttökuva koneen lisäämisestä, joka näyttää yhteensä 77 ennen kuin lisäät 77. 77 lisätään juoksevaan kokonaissummaan.

Käyttäjä valitsee Lisää-painikkeen jälleen.
Näyttökuva laskimen lisäämisestä, joka näyttää yhteensä 154 käyttökerrasta, ennen kuin käyttäjä valitsee Tyhjennä. 77 on taas lisätty juoksevaan kokonaissummaan, jolloin tuloksena on 154.

Käyttäjä valitsee Tyhjennä-painikkeen.
Näyttökuva tietokoneen lisäämisestä sen jälkeen, kun juokseva summa on palautettu nollaksi. Juoksevaksi kokonaissummaksi palautetaan 0.

Laskurimme käyttää jotain, mikä puuttuu Excelistä: painiketta. Tässä sovelluksessa ei voi käyttää vain kaavoja juoksevan summan laskemiseen, koska sen arvo vaihtelee useiden käyttäjän valitsemien toimintojen mukaan. Sen sijaan juokseva summa on tallennettava ja päivitettävä manuaalisesti. Useimmat ohjelmointityökalut tallentavat nämä tiedot muuttujaan.

Joskus tarvitset muuttujan sovellukseen, jotta se toimisi haluamallasi tavalla. Tehtävä ei ole helppo:

  • Juokseva summa täytyy päivittää manuaalisesti. Automaattinen uudelleenlaskenta ei tee sitä puolestasi.
  • Et voi laskea juoksevaa summaa muiden ohjausobjektien arvojen perusteella. Tämä vaihtelee sen mukaan, miten monta kertaa käyttäjä valitsi Lisää-painikkeen ja mikä arvo tekstisyötteen ohjausobjektissa oli kullakin kerralla. Lisäsikö käyttäjä luvun 77 ja valitsi Lisää kahdesti, vai määrittikö hän luvut 24 ja 130 kullekin lisäykselle? Eroa ei ole, kun kokonaismäärä saavuttaa luvun 154.
  • Muutokset summaan voivat olla peräisin eri poluilta. Tässä esimerkissä sekä Lisää- että Tyhjennä-painikkeilla voidaan päivittää summa. Jos sovellus ei toimi odotetulla tavalla, kumpi painike aiheuttaa ongelman?

Käytä yleistä muuttujaa

Jotta voit luoda laskinkoneen, tarvitset muuttujan, joka sisältää juoksevan summan. Helpoiten käytettävät Power Fx -muuttujat ovat yleisiä muuttujia.

Näin yleiset muuttujat toimivat:

  • Yleisen muuttujan arvo voidaan määrittää Set-funktiolla . Set( MyVar, 1 ) asettaa yleisen muuttujan MyVar arvoon 1.
  • Käytä yleistä muuttujaa viittaamalla nimeen, jota käytit Set-funktion kanssa. Tässä tapauksessa MyVar palauttaa arvon 1.
  • Yleiset muuttujat voivat sisältää mitä tahansa arvoja, mukaan lukien merkkijonoja, lukuja, tietueita ja taulukkoja.

Rakennetaan laskuri uudelleen käyttämällä yleistä muuttujaa:

  1. Lisää tekstisyötteen ohjausobjekti nimeltä TextInput1 ja kaksi painiketta nimeltä Button1 ja Button2.

  2. Määritä Button1-painikkeen Teksti-ominaisuudeksi Lisää ja Button2-painikkeen Teksti-ominaisuudeksi Tyhjennä.

  3. Jotta juokseva summa päivittyisi aina, kun käyttäjä valitsee Lisää-painikkeen, määritä sen OnSelect-ominaisuudeksi seuraava kaava:

    Set( RunningTotal, RunningTotal + TextInput1.Text )

    Pelkkä tämän kaavan olemassaolo määrittää RunningTotal:n yleiseksi muuttujaksi, jossa on numero, koska sillä on +-operaattori. Voit viitata RunningTotal:iin missä tahansa sovelluksen sisällä. Kun käyttäjä avaa tämän sovelluksen, RunningTotalsisältää alkuarvon, joka on tyhjä.

    Kun käyttäjä valitsee Lisää-painikkeen ja Set, suoritetaan, RunningTotal-arvoksi määritetään RunningTotal + TextInput1.

    Näyttökuva Lisää-painikkeen OnSelect-ominaisuudesta, joka päivittää yleisen Power Fx -muuttujan Set-toiminnolla.

  4. Jotta juokseva summa määritettäisiin 0 aina, kun käyttäjä valitsee Tyhjennä-painikkeen, määritä sen OnSelect-ominaisuudeksi seuraava kaava:

    Set( RunningTotal, 0 )

    Näyttökuva Tyhjennä-painikkeen OnSelect-ominaisuudesta, joka nollaa yleisen Power Fx -muuttujan Set-toiminnolla.

  5. Lisää Selite-ohjausobjekti ja määritä sen Teksti-ominaisuudeksi RunningTotal.

    Tämä kaava laskee automaattisesti uudelleen ja näyttää käyttäjälle RunningTotal-arvon sen muuttuessa käyttäjän valitsemien painikkeiden perusteella.

    Näyttökuva otsikon Teksti-ominaisuudesta, joka näyttää yleisen RunningTotal-muuttujan arvon.

  6. Esikatsele sovellusta, ja sinulla on laskin edellä kuvattujen ohjeiden mukaisesti. Kirjoita numero tekstiruutuun ja paina Lisää-painiketta muutaman kerran. Kun olet valmis, palaa authoring-käyttökokemukseen Esc-näppäimellä .

    Näyttökuva koneen lisäämisen esikatselusta, jossa on syötearvo ja laskettu juokseva summa.

  7. Jos haluat nähdä yleisen muuttujan arvon, valitse Tiedosto-valikko ja sitten Muuttujat vasemmanpuoleisesta ruudusta.

    Näyttökuva yleinen Muuttujat-vaihtoehdosta, joka on valittu sovelluseditorin Tiedosto-valikosta.

  8. Jos haluat näyttää kaikki paikat, joissa muuttuja on määritetty ja sitä käytetään, valitse se.

    Näyttökuva sijainneista, joissa yleinen muuttuja määritetään ja sitä käytetään sovelluksessa.

Muuttujien tyypit

Power Fx:ssä on kaksi muuttujatyyppiä:

Muuttujan tyyppi Käyttöalue Kuvaus Funktiot, jotka määrittävät
Yleiset muuttujat Sovellus Helpoin käyttää. Sisältää luvun, tekstimerkkijonon, totuusarvon, tietueen, taulukon ja paljon muuta. Voit viitata siihen mistä tahansa sovelluksen kohdasta. Aseta
Collections Sovellus Sisältää taulukon, johon voit viitata mistä tahansa sovelluksen kohdasta. Voit muokata taulukon sisältöä sen sijaan, että määrittäisit sen kokonaan. Voit tallentaa sen paikalliseen laitteeseen myöhempää käyttöä varten. Collect
ClearCollect

Kun käytät Power Apps, näet kolmannen muuttujatyypin:

Muuttujan tyyppi Käyttöalue Kuvaus Funktiot, jotka määrittävät
Kontekstimuuttujat Näyttö Sopii hyvin arvojen välittämiseen näyttöön, kuten parametrit toimintosarjassa muissa kielissä. Voit viitata siihen vain yhdestä näytöstä. UpdateContext
Siirtyminen

Muuttujien luominen ja poistaminen

Voit luoda kaikki muuttujat implisiittisesti, kun ne näkyvät Set-, UpdateContext-, Navigate-, Collect- tai ClearCollect-funktioissa. Jos haluat määrittää muuttujan ja sen tyypin, sisällytä se mihin tahansa näistä funktioista missä tahansa sovelluksessasi. Mikään näistä toiminnoista ei luo muuttujia, ne vain täyttävät muuttujat arvoilla. Muuttujia ei koskaan ilmoiteta erikseen samalla tavalla kuin jossakin toisessa ohjelmointityökalussa, ja kaikki tyypitys on implisiittistä toimintaa.

Sinulla voi olla esimerkiksi painikeohjausobjekti, jonka OnSelect-kaava obn Set( X, 1 ). Tämän kaavan avulla määritetään X muuttujaksi, jonka tyyppi on numero. Voit käyttää X:ää kaavoissa numerona, ja muuttujan arvo on tyhjä, kun sovellus avataan, mutta ennen painikkeen valitsemista. Kun valitset-painikkeen, annat X:lle arvo 1.

Jos lisäät toisen painikkeen ja määrität sen OnSelect-ominaisuudeksiSet( X, "Hello" ), ilmenee virhe, koska tyyppi (tekstimerkkijono) ei vastaa edellisessäjoukossa (luku) olevaa tyyppiä. Kaikkien muuttujan implisiittisten määritysten on oltava yhdenmukaisia tyypin suhteen. Kaikki tämä tapahtui, koska mainitsit X :n kaavoissa, et siksi, että mitään näistä kaavoista todella suoritit.

Voit poistaa muuttujan poistamalla kaikki Set-, UpdateContext-, Navigate-, Collect- ja ClearCollect-funktiot, jotka implisiittisesti määrittävät muuttujan. Jos näitä toimintoja ei ole, muuttujaa ei ole. Sinun on myös poistettava kaikki viittaukset muuttujaan, koska ne aiheuttavat virheen.

Muuttujan käyttöikä ja alkuarvo

Sovellus sisältää kaikki muuttujat muistissa, kun sitä suoritetaan. Kun sovellus sulkeutuu, muuttujien sisältämät arvot menetetään.

Voit tallentaa muuttujan sisällön tietolähteessä käyttämällä Patch- tai Collect-funktioita. Voit myös tallentaa arvoja kokoelmiin paikallisessa laitteessa käyttämällä SaveData-toimintoa.

Kun käyttäjä avaa sovelluksen, kaikkien muuttujien alkuarvo on tyhjä.

Lukumuuttujat

Käytä muuttujan nimeä sen arvon lukemiseen. Voit esimerkiksi määrittää muuttujan seuraavalla kaavalla:

Set( Radius, 12 )

Sen jälkeen voit käyttää sädettä missä tahansa, missä voit käyttää numeroa, ja se korvaa luvun 12:

Pi() * Power( Radius, 2 )

Jos annat kontekstimuuttujalle saman nimen kuin yleisellä muuttujalla tai kokoelmalla, kontekstimuuttuja on etusijalla. Voit kuitenkin edelleen viitata yleiseen muuttujaan tai kokoelmaan käyttämällä selvitysoperaattoria[@Radius].

Kontekstimuuttujan käyttäminen (vain Power Apps)

Seuraavassa on ohjeet siihen, miten voit luoda laskin käyttämällä kontekstimuuttujaa yleisen muuttujan sijaan.

Näin kontekstimuuttujat toimivat:

  • Kontekstimuuttujat luodaan implisiittisesti käyttämällä UpdateContext- tai Navigate-funktiota. Kun sovelluksen käynnistyy, kaikkien kontekstimuuttujien arvo on tyhjä.
  • Kontekstimuuttujat päivitetään tietueiden kanssa. Muissa ohjelmointityökaluissa voidaan yleisesti käyttää merkkiä ”=” vastaamaan varausta, kuten ”x = 1”. Kontekstimuuttujien yhteydessä on käytössä { x: 1 }. Kun käytät kontekstimuuttujaa, käytä sen nimeä suoraan ilman tietueen syntaksia.
  • Voit myös määrittää kontekstimuuttujan käyttämällä Navigate-funktiota näytön näyttämiseen. Jos kuvittelet näytön olevan eräänlainen toimintosarja tai aliohjelma, tämä lähestymistapa muistuttaa parametrin välittämistä muissa ohjelmointityökaluissa.
  • Siirry-funktiota lukuun ottamatta kontekstimuuttujat on rajoitettu yhden näytön kontekstiin, jossa ne saavat nimensä. Niitä ei voi käyttää tai määrittää tämän kontekstin ulkopuolella.
  • Kontekstimuuttujat voivat sisältää mitä tahansa arvoja, mukaan lukien merkkijonoja, lukuja, tietueita ja taulukkoja.

Rakennetaan laskuri uudelleen käyttämällä kontekstimuuttujaa:

  1. Lisää tekstisyötteen ohjausobjekti nimeltä TextInput1 ja kaksi painiketta nimeltä Button1 ja Button2.

  2. Määritä Button1-painikkeen Teksti-ominaisuudeksi Lisää ja Button2-painikkeen Teksti-ominaisuudeksi Tyhjennä.

  3. Jotta juokseva summa päivittyisi aina, kun käyttäjä valitsee Lisää-painikkeen, määritä sen OnSelect-ominaisuudeksi seuraava kaava:

    UpdateContext( { RunningTotal: RunningTotal + TextInput1.Text } )

    Pelkkä tämän kaavan olemassaolo määrittää RunningTotal:n kontekstimuuttujaksi, jossa on numero, koska sillä on +-operaattori. Voit viitata RunningTotal:iin missä tahansa tässä näytössä. Kun käyttäjä avaa tämän sovelluksen, RunningTotalsisältää alkuarvon, joka on tyhjä.

    Kun käyttäjä valitsee Lisää-painikkeen ja UpdateContext suoritetaan, RunningTotal-arvoksi määritetään RunningTotal + TextInput1.

    Näyttökuva Lisää-painikkeen OnSelect-ominaisuudesta, joka päivittää RunningTotal-kontekstimuuttujan.

  4. Jotta juokseva summa määritettäisiin 0 aina, kun käyttäjä valitsee Tyhjennä-painikkeen, määritä sen OnSelect-ominaisuudeksi seuraava kaava:

    UpdateContext( { RunningTotal: 0 } )

    UpdateContext-funktiota käytetään kaavan UpdateContext( { RunningTotal: 0 } ) kanssa.

    Näyttökuva Tyhjennä-painikkeen OnSelect-ominaisuudesta, joka nollaa RunningTotal-kontekstimuuttujan.

  5. Lisää Selite-ohjausobjekti ja määritä sen Teksti-ominaisuudeksi RunningTotal.

    Tämä kaava laskee automaattisesti uudelleen ja näyttää käyttäjälle RunningTotal-arvon sen muuttuessa käyttäjän valitsemien painikkeiden perusteella.

    Näyttökuva otsikon Teksti-ominaisuudesta, joka näyttää RunningTotal-kontekstimuuttujan arvon.

  6. Esikatsele sovellusta, ja sinulla on laskin edellä kuvattujen ohjeiden mukaisesti. Kirjoita numero tekstiruutuun ja paina Lisää-painiketta muutaman kerran. Kun olet valmis, palaa authoring-käyttökokemukseen Esc-näppäimellä .

    Näyttökuva sovelluksen esikatselusta, jossa on tekstisyötearvo ja kontekstimuuttuja, joka suorittaa summan.

  7. Voit määrittää kontekstimuuttujan arvon siirtyessäsi näyttöön. Tästä menetelmästä on hyötyä välitettaessa kontekstia tai parametreja näytöstä toiseen. Tätä tekniikkaa voidaan esitellä lisäämällä näyttö, lisäämällä painike ja määrittämällä sen OnSelect-ominaisuudeksi tämä kaava:

    Navigate( Screen1, None, { RunningTotal: -1000 } )

    Näyttökuva OnSelect-painikkeen ominaisuudesta, jossa Siirry-toiminnolla voit välittää kontekstimuuttujan Screen1:een.

    Pidä Alt-näppäintä painettuna, kun valitset tämän painikkeen. Sen jälkeen sekä näytetään Screen1 että määritetään kontekstimuuttuja RunningTotal arvoksi -1000.

    Näyttökuva Screen1-näytöstä siirtymisen jälkeen määrittää RunningTotal-kontekstimuuttujan negatiiviseksi 1000:ksi.

  8. Jos haluat nähdä kontekstimuuttujan arvon, valitse Tiedosto-valikko ja sitten Muuttujat vasemmanpuoleisesta ruudusta.

    Näyttökuva kontekstimuuttujat-vaihtoehdosta, joka on valittu sovelluseditorin Tiedosto-valikosta.

  9. Valitse kontekstimuuttuja, jotta näet, missä se on määritetty ja missä sitä käytetään.

    Näyttökuva sijainneista, joissa kontekstimuuttuja määritetään ja sitä käytetään sovelluksessa.

Kokoelmien käyttö

Tutustutaan lopuksi lisäyslaskimen luontiin kokoelman avulla. Koska kokoelma sisältää taulukon, jota voit helposti muokata, tämä laskin säilyttää "paperinauhan" kustakin arvosta kirjoittaessasi niitä.

Näin kokoelmat toimivat:

  • ClearCollect-funktiolla voit luoda ja määrittää kokoelmia. Voit käyttää sen sijaan Collect-funktiota , mutta käytännössä se edellyttää toista muuttujaa vanhan muuttujan korvaamisen sijaan.
  • Kokoelma on eräänlainen tietolähde ja näin ollen taulukko. Voit käyttää kokoelman yhtä arvoa First-funktion avulla ja poimia yhden kentän tuloksena saatavasta tietueesta. Jos käytät yksittäistä arvoa ClearCollect-funktion kanssa, tämä arvo on Arvo-kenttä , kuten tässä esimerkissä:
    First(VariableName).Value

Luodaan seuraavaksi laskin uudelleen kokoelman avulla:

  1. Lisää Tekstisyöte-ohjausobjekti TextInput1 ja kaksi painiketta Button1 ja Button2.

  2. Määritä Button1-painikkeen Teksti-ominaisuudeksi Lisää ja Button2-painikkeen Teksti-ominaisuudeksi Tyhjennä.

  3. Jotta juokseva summa päivittyisi aina, kun käyttäjä valitsee Lisää-painikkeen, määritä sen OnSelect-ominaisuudeksi seuraava kaava:

    Collect( PaperTape, TextInput1.Text )

    Pelkkä tämän kaavan olemassaolo määrittää PaperTape:n kokoelmaksi, joka sisältää yksisarakkeisen tekstimerkkijonotaulukon. Voit viitata PaperTape:en missä tahansa tämän sovelluksen sisällä. Kun käyttäjä avaa tämän sovelluksen, PaperTape on tyhjä taulukko.

    Tämä kaava suoritetaan, se lisää uuden arvon kokoelman loppuun. Koska lisäät yksittäisen arvon, Collect sijoittaa sen automaattisesti yksisarakkeiseen taulukkoon, ja sarakkeen nimi on Arvo, jota käytät myöhemmin.

    Näyttökuva Lisää-painikkeen OnSelect-ominaisuudesta, joka kerää syötearvon PaperTape-kohteessa.

  4. Jotta paperinauha tyhjenee käyttäjän valitessa Tyhjennä-painikkeen, määritä sen OnSelect-ominaisuudeksi tämä kaava:

    Clear( PaperTape )

    Näyttökuva Tyhjennä-painikkeen OnSelect-ominaisuudesta, joka tyhjentää kaikki arvot PaperTapesta.

  5. Näytä juokseva summa lisäämällä nimi, ja määritä sen Teksti-ominaisuudeksi tämä kaava:

    Sum( PaperTape, Value )

    Näyttökuva selitteen Teksti-ominaisuudesta, jossa lasketaan PaperTapen juokseva summa Summa-funktion avulla.

  6. Suorita laskin painamalla F5-näppäintä, mikä avaa esikatselun, lisää lukuja tekstisyötteen ohjausobjektiin ja valitse painikkeet.

    Näyttökuvassa on kokoelmapohjainen laskin, jossa on syötearvo ja juokseva summa.

  7. Palaa oletustyötilaan painamalla Esc-näppäintä .

  8. Näytä paperinauha lisäämällä Arvotaulukko-ohjausobjekti ja määritä sen Kohteet-ominaisuudeksi tämä kaava:

    PaperTape

    Valitse oikeanpuoleisesta ruudusta Muokkaa kenttiä ja valitse sitten Lisää kenttä, valitse Arvo-sarake ja valitse sitten Lisää, jotta kenttä näkyy.

    Näyttökuva tietotaulukosta, joka näyttää PaperTape-kokoelmaan lisätyt arvot.

  9. Näytä kokoelman arvot valitsemalla Tiedosto-valikosta Kokoelmat.

    Näyttökuva Kokoelmat-näkymästä, joka näyttää PaperTape-kokoelmaan tallennetut arvot.

  10. Tallenna ja nouda kokoelma lisäämällä kaksi muuta painikeohjausobjektia ja määrittämällä niiden Text-ominaisuuksiksi Lataa ja Tallenna. Määritä Lataa-painikkeen OnSelect-ominaisuudeksi tämä kaava:

    Clear( PaperTape ); LoadData( PaperTape, "StoredPaperTape", true )

    Joudumme ensin tyhjentämään kokoelman, koska LoadData liittää tallennetut arvot kokoelman loppuun.

    Näyttökuva Lataa-painikkeen OnSelect-ominaisuudesta, joka tyhjentää ja lataa PaperTape-kokoelman.

  11. Määritä Tallenna-painikkeen OnSelect-ominaisuudeksi seuraava kaava:

    SaveData( PaperTape, "StoredPaperTape" )

    Näyttökuva Tallenna painikkeen OnSelect-ominaisuudesta, joka tallentaa PaperTape-kokoelman paikallisesti.

  12. Esikatsele uudelleen painamalla F5-näppäintä , kirjoita luvut tekstisyötteen ohjausobjektiin ja valitse painikkeet. Valitse Tallenna-painike. Sulje ja lataa sovellus uudelleen ja lataa kokoelma uudelleen valitsemalla Lataa-painike.