Kaaviokomponentin ominaisuudet

Kaaviokomponentit avulla kehittäjät voivat luoda erityyppisiä ominaisuuksia arvojen tai logiikan välittämiseksi komponentin ja komponenttia isännöivän sovelluksen välillä. Ominaisuudet ovat välttämättömiä interaktiivisten, uudelleenkäytettävien komponenttien rakentamisessa.

edellytykset

Tämä ominaisuus on uusissa sovelluksissa käytössä oletusaroisesti. Jos kyseessä on olemassa oleva sovellus, se on otettava käyttöön sovellusasetuksissa.

1. Avaa pohjaan perustuva sovellus muokattavaksi Power Apps Studiossa. Valitse komentopalkista Asetukset>Päivitykset.

2. Etsi Uusi-välilehdessä Laajennettujen komponenttien ominaisuudet -asetus ja ota se käyttöön.

Ominaisuuksien tyypit

Tekijöillä on neljän tyypin ominaisuuksia käytettävissä.

1. Tieto-ominaisuudet: Tieto-ominaisuudet koskevat värin ja tekstiarvon kaltaisia tietoja. Tieto-ominaisuuden voi määrittää Syötteeksi tai Tulosteeksi, mikä ilmaisee, tarjoaako komponentti tietoja sovellukselle (Tuloste) vai tarjoaako sovellus tietoja komponentille(Syöte). Tieto-ominaisuudet ovat ainoat ominaisuudet, jotka osallistuvat sovelluksen tietojenkulkuun.
2. Funktio-ominaisuudet: Funktio-ominaisuudet liittyvät logiikkaan, kuten tiettyihin parametreihin perustuvan laskutoimituksen tekemiseen tai tekstin muuttamiseen. Funktio-ominaisuuden voi määrittää Syötteeksi tai Tulosteeksi, mikä ilmaisee, tarjoaako komponentti kutsuttavan funktion sovellukselle (Tuloste) vai tarjoaako sovellus kutsuttavan funktion komponentille (Syöte). Funktio-ominaisuudet eivät osallistu sovelluksen tiedonkulkuun ja ne eivät voi käyttää komponentin tai sovelluksen muuttujia.
3. Toiminnon ominaisuudet: Toiminnon ominaisuudet kuuluvat ominaisuustyyppiin, joka käsittelee logiikkaa. Ne toimivat tulosfunktion tavoin. Komponentille on siten määritetty logiikka, ja tämä logiikka voi käyttää ketjutettuja lausekkeita ja käsitellä kokoelmia tai muuttujia ("toiminta"). Esimerkiksi toiminnon ominaisuus Clear() voi määrittää toimintoja, joita sovellus kutsuu tyhjentääkseen joitakin komponentin arvoja tai toiminnon ominaisuus Save() päivittää tietolähteen.
4. Tapahtuman ominaisuudet: Tapahtuman ominaisuudet on ominaisuusluokka, joka sisältää logiikan ja funktiot syötefunktiona. Sovellus siis määrittää logiikan, jonka komponentti voi kutsua, ja tämä logiikka voi käyttää ketjutettuja lausekkeita ja käsitellä kokoelmia tai muuttujia ("toiminta"). Tavallisesti näiden ominaisuuksien nimet kuvastavat tapahtumaa kuten OnSelect tai OnChanged.

Tieto-ominaisuus

Tieto-ominaisuuden käyttö on helppo hahmottaa. Sovellusten vakio-ohjausobjekteilla on yleensä useita tieto-ominaisuuksia, kuten oletusarvojen, tekstin värin ja koon määrittäminen. Tarkastellaan yksinkertaista esimerkkiä, jossa haluat komponentin ohjausobjektin ominaisuuksien olevan isännöintisovelluksen käytettävissä. Tässä esimerkissä komponentti on nimeltään Component1. Aseta liukusäädin komponentin sisään. Lisää Syöte-ominaisuus määrittämään kuluttavan sovelluksen väri ja Tulos-ominaisuus, jotta komponentti voi kertoa sovellukselle liukusäätimen kulloisenkin arvon. Tässä esimerkissä oletetaan, että komponentilla Liukusäädin-ohjausobjekti nimeltä Slider.

1. Valitse komponentin ominaisuusruudussa Uusi mukautettu ominaisuus.
2. Syötä Uusi mukautettu ominaisuus -ruudussa näyttönimi Slider Color.
3. Valitse Ominaisuuden tyyppi -kohdassa Tiedot ja valitse Ominaisuusmäärityksen arvo Syöte.
4. Valitse lopuksi avattavasta Tietotyyppi-luettelosta Väri.
5. Valitse Luo.

Valitse seuraavaksi Liukusäädin-ohjausobjekti Slider1. Etsi sen ValueFill-ominaisuus ja syötä kaavariville Component1.SliderColor. Component1 on komponentin nimi ja SliderColor lisäämäsi ominaisuuden nimi.

Nyt komponentilla on ominaisuus SliderColor, joka voidaan määrittää kuluttavassa sovelluksessa välittämään väri komponentille ja määrittämään liukusäätimen ValueFill-ominaisuus.

Haluat ehkä myös antaa liukusäätimen arvon kuluttavalle sovellukselle. Lisää tätä varten Tulos-ominaisuus.

1. Valitse komponentin ominaisuusruudussa Uusi mukautettu ominaisuus.
2. Syötä Uusi mukautettu ominaisuus -ruudussa näyttönimi Slider Value.
3. Valitse Ominaisuuden tyyppi -kohdassa Tiedot ja valitse Ominaisuusmäärityksen arvo Tuloste.
4. Valitse lopuksi avattavasta Tietotyyppi-luettelosta Numero.
5. Valitse Luo.

Kun Tieto-ominaisuus on Tuloste, komponentti tarjoaa arvon käyttävälle sovellukselle. Määritä kaava määrittämällä komponentin uudeksi SliderValue -ominaisuudeksi liukusäätimen Arvo-ominaisuus.

1. Valitse komponentin ominaisuusruudussa Slider Value -ominaisuus.
2. Korvaa kaavarivillä oletusarvo 100 seuraavalla kaavalla: Slider1.Value.

Nyt komponentin SliderValue-ominaisuus vastaa komponentin sisällä olevan liukusäätimen arvoa, jonka kuluttava sovellus voi lukea.

Funktio-ominaisuus

Funktio-ominaisuus sisältää lausekkeen, joka palauttaa arvon. Yleensä funktio käyttää argumentteja, joita se käyttää palautettavan arvon laskemiseen.

Muistiinpano

Toiminto-ominaisuudet eivät tällä hetkellä voi käyttää muuttujia tai komponenttien arvoja ja ominaisuuksia. Ne eivät voi myöskään käynnistää tietojen työnkulkua. Pakolliset arvot on välitettävä argumentteina.

Tuloste-funktio on yksinkertainen tapa luoda mukautettu funktio Power Appsille. Komponentti määrittää Tuloste-funktion, jossa on lauseke. Lauseke ottaa tietyt argumentit ja palauttaa arvon. Tätä funktiota voi sitten käyttää sovelluksessa käyttämällä komponentin nimeä (esimerkiksi Component1), kutsumalla kohteen Component1.MyFunction(arg1, arg2).

Kuluttava sovellus voi Syöte-funktion avulla toimittaa komponentille logiikkaa, joka muistuttaa funktio-osoitinta tai vastakutsutoimintoa. Jos komponentti esimerkiksi käsittelee henkilöiden nimiä, sillä voi olla syöttöfunktio, joka sisältää argumentit firstname ja lastname ja odottaa palautteeksi merkkijonoa. Sovellus voi määrittää funktiolausekkeen, joka palauttaa arvon $"{firstname} {lastname}" tai $"{lastname}, {firstname}". Komponentti kutsuu sovelluksen tekijän tarjoamaa funktiota ja käyttää palautettua merkkijonoa.

Toiminto-ominaisuus

Toiminto-ominaisuudet ovat samanlaisia kuin Tuloste-tyyppiset funktio-ominaisuudet, mutta ne sallivat sivuvaikutuskaavat ja lausekkeiden ketjutuksen. Komponentilla voi olla AddRecord-niminen toiminto-ominaisuus, jonka avulla sovellus voi lisätä tietueen komponentin sisällä olevaan kokoelmaan, tai Reset-toiminto, joka tyhjentää komponentin sisällä olevat muuttujat tai kokoelmat.

Aiemmassa Tieto-ominaisuutta koskeneessa liukusäädinesimerkissä liukusäädin voidaan asettaa takaisin oletusarvoonsa lisäämällä toiminto-ominaisuus nimeltä ResetValue. Tähän käytetään kaavaa Reset( Slider1 ). Nyt sovelluksessa olevat komponentin esiintymät voivat kutsua kaavaa Component1.ResetValue() asettaakseen liukusäätimen takaisin oletusarvoonsa.

Tapahtumaominaisuus

Monilla vakio-ohjausobjekteilla on yhteisiä Tapahtuma-tyyppisiä ominaisuuksia, jotka ovat syötekäyttäytymisen funktio-ominaisuuksia. OnSelect painikeohjausobjektissa on tästä yleinen esimerkki. Komponentti voi määrittää tapahtumaominaisuuksia ja kutsua näitä tapahtumia kuin funktiota. Esimerkiksi komponentilla, jossa on painikeohjausobjekti, voi olla tapahtumaominaisuus nimeltä OnButtonClicked. Painikkeen ohjausobjektin kohdassa OnSelect komponentti voi kutsua Component1.OnButtonClicked()-ominaisuutensa. Kuluttava sovellus voi määrittää tälle ominaisuudelle oman logiikkansa, joka toimii, kun komponentin sisällä olevaa painiketta painetaan.

Ominaisuuksien tai argumenttien oletusarvot

Oletusarvot antavat argumentille tai ominaisuudelle arvon, jos sitä ei ole määritetty. Tämä ei ole järkevää tietyntyyppisille ominaisuuksille. Joissakin tapauksissa voit käyttää oletusarvoja tietueen odotetun rakenteen näyttämiseen. Antamalla oletustietueen määrität tietuetyypin odotetuksi rakenteeksi.

Esimerkiksi Toiminto-ominaisuus nimeltä AddRecord poimii tietueen lisättäväksi paikalliseen kokoelmaan. Voit näyttää odotetun tietueen rakenteen lisäämällä oletusarvon AddRecord-ominaisuuden argumentille.