Drobės komponento ypatybės (eksperimentinės)

Drobės komponentai leidžia kūrėjams kurti įvairių tipų ypatybes, kad būtų galima perduoti reikšmes arba logiką tarp komponento ir programos, kurioje yra komponentas. Savybės yra esminė interaktyvių ir daugkartinio naudojimo komponentų kūrimo dalis.

Savybių tipai

Kūrėjams yra keturių tipų ypatybės:

1. Duomenų ypatybės: duomenų ypatybės susijusios su duomenimis, pvz., spalva arba teksto reikšmė. Duomenų ypatybę galima nustatyti kaip Įvestis arba Išvestis, kuri nurodo, ar komponentas teikia duomenis programai (Išvestis ·), ar programa pateikia duomenis komponentui (Įvestis ·). Duomenų nuosavybės yra vienintelės nuosavybės, dalyvaujančios programos duomenų sraute.
2. Funkcijos ypatybės: funkcijos ypatybės yra susijusios su logika, pvz., skaičiavimo atlikimu pagal konkrečius parametrus arba teksto keitimu. Funkcijos ypatybę galima nustatyti kaip Įvestis arba Išvestis, kuri nurodo, ar komponentas teikia funkciją, kurią programa gali iškviesti (Išvestis ·), ar programa teikia funkciją, kurią komponentas gali iškviesti (Įvestis ·). Funkcijų ypatybės nedalyvauja programos duomenų sraute ir negali naudoti komponentų ar programos kintamųjų.
3. Veiksmo ypatybės: veiksmo ypatybės yra ypatybės tipas, susijęs su logika ir veikiantis kaip išvesties funkcija. Taigi komponentas turi apibrėžtą logiką, ir ta logika gali naudoti grandinines išraiškas ir manipuliuoti rinkiniais ar kintamaisiais ("elgesys"). Pavyzdžiui, ypatybė Veiksmas Clear() gali suteikti funkcijų, kurias programa gali iškviesti, kad išvalytų kai kurias komponento reikšmes, arba veiksmo Save() ypatybę, kuri atnaujina duomenų šaltinį.
4. Įvykio ypatybės: įvykio ypatybės yra ypatybių kategorija, kuri apima logiką ir veikia kaip įvesties funkcija. Taigi programa apibrėžia logiką, kurią komponentas gali iškviesti, ir ta logika gali naudoti grandinines išraiškas ir manipuliuoti rinkiniais ar kintamaisiais ("elgesys"). Paprastai šių ypatybių pavadinimai atspindi įvykį, pvz., OnSelect arba OnChanged.

Duomenų ypatybė

Duomenų ypatybės naudojimą lengva įsivaizduoti. Standartiniai valdikliai programose paprastai turi keletą duomenų ypatybių, kad būtų galima nustatyti numatytąsias reikšmes, teksto spalvą, dydį ir kt. Pažvelkime į paprastą pavyzdį, kai norime, kad komponento valdiklio ypatybės būtų prieinamos prieglobos programai. Šiame pavyzdyje mūsų komponentas yra pavadintas Component1. Į savo komponento vidų įdėsime slankiklio valdiklį. Turėsime įvesties ypatybę, kad nurodytume spalvą iš vartojančios programos, ir išvesties ypatybę, kurioje komponentas gali nurodyti programai, kokia yra dabartinė slankiklio vertė. Toliau pateiktame pavyzdyje daroma prielaida, kad jūsų komponente yra slankiklio valdiklis, pavadintas Slider.

1. Komponento ypatybių srityje pasirinkite Nauja pasirinktinė ypatybė.
2. Srityje Nauja pasirinktinė ypatybė įveskite rodomą pavadinimą Slider Color.
3. Pasirinkite Duomenų ypatybės tipas ir pasirinkite Ypatybės apibrėžimo reikšmė Įvestis.
4. Galiausiai išskleidžiamajame meniu Duomenų tipas pasirinkite Spalva.
5. Spustelėkite Kurti.

Tada pasirinkite Slider1 slankiklio valdiklį. Raskite jo ypatybę ValueFill ir formulės juostoje įveskite Component1.SliderColor. Component1 nurodo mūsų komponento pavadinimą ir SliderColor yra ypatybės, kurią pridėjome anksčiau, pavadinimas.

Dabar mūsų komponentas turi SliderColor savybę, kurią galima nustatyti vartojimo programoje, kad būtų galima perduoti spalvą į komponentą, kad būtų galima nustatyti slankiklio "ValueFill " ypatybę.

Taip pat norime pateikti slankiklio vertę vartojančiai programai. Norėdami tai padaryti, pridėsime ypatybę Išvestis .

1. Komponento ypatybių srityje pasirinkite Nauja pasirinktinė ypatybė.
2. Srityje Nauja pasirinktinė ypatybė įveskite rodomą pavadinimą Slider Value.
3. Pasirinkite Duomenų ypatybės tipas ir pasirinkite Ypatybės apibrėžimo reikšmė Išvestis.
4. Galiausiai išskleidžiamajame meniu Duomenų tipas pasirinkite Skaičius.
5. Spustelėkite Kurti.

Kai duomenų ypatybė yra Išvestis, komponentas pateikia reikšmę vartojančiai programai. Norėdami nustatyti formulę, turime nustatyti naują SliderValue komponento ypatybę į slankiklio ypatybę Reikšmė .

1. Komponento ypatybių srityje spustelėkite Slider Value ypatybę.
2. Formulės juostoje pakeiskite numatytąją reikšmę 100 tokia formule: Slider1.Value.

Dabar mūsų komponento SliderValue nuosavybė atspindės komponento viduje esančio slankiklio vertę, kurią vėliau bus galima perskaityti iš vartojančios programos.

Funkcijos ypatybė

Funkcijos ypatybėje yra išraiška, kuri pateikia reikšmę. Paprastai funkcija naudoja kai kuriuos argumentus, kuriuos ji naudoja apskaičiuodama arba nustatydama grąžintiną reikšmę.

Išvesties funkcija yra paprastas būdas sukurti pasirinktinę funkciją Power Apps. Komponentas apibrėžia išvesties funkciją su reiškiniu, kuris paima kai kuriuos argumentus ir pateikia reikšmę. Tada šią funkciją galima naudoti programoje naudojant komponento pavadinimą (tarkime Component1) skambinant Component1.MyFunction(arg1, arg2).

Įvesties funkcija yra būdas, kuriuo naudojanti programa suteikia komponentui logikos, panašios į funkcijų žymeklį arba atgalinio iškvietimo funkciją. Pavyzdžiui, jūsų komponentas gali būti susijęs su žmonių vardais ir turėti įvesties funkciją su argumentais firstname bei lastname gerbti eilutę atgal. Programa gali apibrėžti funkcijos išraišką, kurią $"{firstname} {lastname}" norite grąžinti $"{lastname}, {firstname}", arba pasirinkti apibrėžti išraišką. Komponentas gali tiesiog iškviesti programos kūrėjo pateiktą funkciją ir naudoti grąžintą eilutę.

Veiksmo ypatybė

Veiksmo ypatybės yra panašios į tipo Išvestis funkcijos ypatybes, tačiau jos leidžia šalutinio poveikio formules ir išraiškos grandinę. Komponentas gali turėti veiksmo ypatybę, pavadintą AddRecord taip, kad programa galėtų įtraukti įrašą į komponento viduje esantį rinkinį, arba veiksmą, kuriuo išvalomi komponento kintamieji arba Reset rinkiniai.

Anksčiau duomenų ypatybei naudotų slankiklio pavyzdžių pavyzdyje galime pristatyti veiksmo ypatybę, iškviestą ResetValue norint nustatyti slankiklį į numatytąją reikšmę. Tam galime naudoti formulę Reset( Slider1 ) . Dabar mūsų komponento egzemplioriai programoje gali iškviesti Component1.ResetValue() , kad slankiklis būtų grąžintas į numatytąją vertę.

Renginio ypatybė

Standartiniuose valdikliuose yra daug įprastų įvykio tipo ypatybių, efektyviai įvesties elgsenos funkcijos ypatybių. OnSelect ant mygtuko valdiklio yra akivaizdžiausias pavyzdys. Komponentas gali apibrėžti bet kokį įvykių ypatybių skaičių ir iškviesti šiuos įvykius kaip funkciją. Pavyzdžiui, komponento, turinčio mygtuko valdiklį, ypatybė gali būti pavadinta OnButtonClicked. Mygtuko valdiklio "OnSelect" komponentas gali iškviesti savo Component1.OnButtonClicked() ypatybę. Tada vartojanti programa gali apibrėžti savo šios ypatybės logiką, kad veiktų paspaudus komponento viduje esantį mygtuką.

Numatytosios ypatybių arba argumentų reikšmės

Numatytosios reikšmės gali pateikti numatytąją argumento arba ypatybės reikšmę, jei ji nenustatyta. Tai nėra prasminga kai kurių tipų savybėms. Tačiau kai kuriais atvejais jie gali būti naudojami norint pateikti numatomą įrašo schemą. Pateikiant numatytąjį įrašą, įrašo tipas nustatomas kaip numatoma schema.

Pavyzdžiui, ypatybė Veiksmas, pavadinta Priimti AddRecord įrašą, kuris bus įtrauktas į vietinį rinkinį. Norėdamas pateikti numatomo įrašo schemą, kūrėjas turi įtraukti numatytąją šios AddRecord ypatybės argumento reikšmę.