Svojstva komponente radnog područja (eksperimentalno)

Komponente radnog područja omogućuju proizvođačima stvaranje različitih vrsta svojstava za prijenos vrijednosti ili logike između komponente i aplikacije u kojoj se nalazi komponenta. Svojstva su bitan dio stvaranja interaktivnih komponenti za višekratnu upotrebu.

Važno

• Ovo je eksperimentalna značajka.
• Eksperimentalne značajke nisu namijenjene u proizvodne svrhe i mogu imati ograničene funkcije. Te su značajke dostupne prije službenog izdavanja da bi se klijentima omogućio prijevremeni pristup i slanje povratnih informacija. Dodatne informacije: Eksperimentalne značajke i značajke pretpregleda
• Ponašanje opisano u ovom članku dostupno je samo kada je uključena eksperimentalna značajka Poboljšana svojstva komponente u postavkama > nadolazećim značajkama > Eksperimentalno (isključeno prema zadanim postavkama).
• Vaše povratne informacije vrlo su nam vrijedne - javite nam što mislite na forumu zajednice eksperimentalnih Power Apps značajki.

Vrste svojstava

Proizvođačima su dostupne četiri vrste svojstava:

1. Svojstva podataka: svojstva podataka odnose se na podatke, kao što su boja ili tekstna vrijednost. Svojstvo Podaci može se postaviti na Ulaz ili Izlaz, što pokazuje daje li komponenta podatke aplikaciji (izlaz) ili aplikacija daje podatke komponenti (ulaz). Svojstva podataka jedina su svojstva koja sudjeluju u protoku podataka aplikacije.
2. Svojstva funkcije: Svojstva funkcije povezana su s logikom, kao što je izvođenje izračuna na temelju određenih parametara ili mijenjanje teksta. Svojstvo funkcije može se postaviti na Ulaz ili Izlaz, što pokazuje pruža li komponenta funkciju koju aplikacija može pozvati (izlaz) ili aplikacija pruža funkciju koju komponenta može pozvati (Ulaz). Svojstva funkcije ne sudjeluju u protoku podataka aplikacije i ne mogu upotrebljavati varijable komponenti ili aplikacije.
3. Svojstva akcije: Svojstva akcije vrsta su svojstva koje se bavi logikom i ponaša se kao izlazna funkcija. Dakle, komponenta ima definiranu logiku, a ta logika može koristiti lančane izraze i manipulirati zbirkama ili varijablama ("ponašanje"). Na primjer, Clear() svojstvo Akcija može pružiti funkcionalnost koju aplikacija može pozvati da izbriše neke vrijednosti u komponenti ili Save() svojstvo Akcija koje ažurira izvor podataka.
4. Svojstva događaja: Svojstva događaja kategorija su svojstva koja uključuje logiku i funkcionira kao ulazna funkcija. Dakle, aplikacija definira logiku koju komponenta može nazvati i ta logika može koristiti vezane izraze i manipulirati zbirkama ili varijablama ("ponašanje"). Nazivi tih svojstava obično odražavaju događaj kao OnSelect što je ili OnChanged.

Svojstvo podataka

Korištenje podatkovnog svojstva lako je zamisliti. Standardne kontrole u aplikacijama obično imaju nekoliko svojstava podataka za postavljanje zadanih vrijednosti, boje teksta, veličine itd. Pogledajmo jednostavan primjer gdje svojstva kontrole unutar komponente želimo učiniti dostupnima aplikaciji za hosting. U ovom primjeru naša komponenta je imenovana Component1. Stavit ćemo kontrolu klizača unutar naše komponente. Imat ćemo svojstvo Ulaz za određivanje boje iz aplikacije koja se troši i svojstvo Izlaz u kojem komponenta može aplikaciji reći koja je trenutna vrijednost klizača. Sljedeći primjer pretpostavlja da komponenta sadrži kontrolu klizača s nazivom Slider.

1. U oknu svojstava komponente odaberite Novo prilagođeno svojstvo.
2. U oknu svojstva Novi prilagođeni unesite zaslonsko ime . Slider Color
3. Odaberite Vrsta svojstva podataka i odaberite Vrijednost definicije svojstva Ulaz.
4. Na kraju, na padajućem izborniku Vrsta podataka odaberite Boja.
5. Kliknite Stvori.

Zatim odaberite Slider1 kontrolu klizača . Pronađite njegovo svojstvo ValueFill i u traku formule unesite Component1.SliderColor. Component1 odnosi se na naziv naše komponente i SliderColor naziv je nekretnine koju smo prethodno dodali.

Sada naša komponenta ima SliderColor svojstvo koje se može postaviti u aplikaciji koja troši, kako bi prenijela boju u komponentu kako bi postavila svojstvo klizača ValueFill .

Također želimo pružiti vrijednost klizača aplikaciji koja troši. Da bismo to postigli, dodat ćemo svojstvo Izlaz. ·

1. U oknu svojstava komponente odaberite Novo prilagođeno svojstvo.
2. U oknu svojstva Novi prilagođeni unesite zaslonsko ime Slider Value.
3. Odaberite Vrsta svojstva podataka i odaberite Vrijednost definicije svojstva Izlaz.
4. Konačno, na padajućem izborniku Vrsta podataka odaberite Broj.
5. Kliknite Stvori.

Kada je svojstvo Podaci Izlaz, komponenta daje vrijednost potrošnji aplikacije. Da bismo postavili formulu SliderValue za to, novo svojstvo u komponenti moramo postaviti na svojstvo klizača Vrijednost .

1. U oknu svojstava komponente kliknite na Slider Value svojstvo.
2. Na traci formule zamijenite zadanu vrijednost 100 sljedeće formule: Slider1.Value

Sada će svojstvo naše komponente SliderValue odražavati vrijednost klizača unutar komponente, koji se zatim može pročitati iz aplikacije koja troši.

Svojstvo funkcije

Svojstvo funkcije sadrži izraz koji vraća vrijednost. Obično funkcija uzima neke argumente koje koristi za izračunavanje ili određivanje vrijednosti koju treba vratiti.

Napomena

Svojstva funkcije trenutno ne mogu pristupiti varijablama ili vrijednostima i svojstvima komponenti i ne mogu pokrenuti protok podataka. Sve potrebne vrijednosti moraju se proslijediti kao argumenti.

Funkcija Output jednostavan je način stvaranja prilagođene funkcije za Power Apps. Komponenta definira izlaznu funkciju s izrazom koji uzima neke argumente i vraća vrijednost. Ta se funkcija zatim može koristiti u aplikaciji pomoću naziva komponente (recimo Component1) pozivom Component1.MyFunction(arg1, arg2).

Funkcija unosa način je na koji aplikacija koja troši pruža logiku komponenti, slično funkcijskoj pokazivaču ili funkciji povratnog poziva. Na primjer, vaša se komponenta možda bavi imenima ljudi i ima ulaznu funkciju s argumentima firstname i lastname poštuje niz natrag. Aplikacija može definirati izraz funkcije za vraćanje $"{firstname} {lastname}" ili može odabrati definiranje izraza za $"{lastname}, {firstname}". Komponenta može samo pozvati funkciju koju je proizvođač aplikacije pružio i koristiti vraćeni niz.

Svojstvo akcije

Svojstva akcije slična su funkcijskim svojstvima vrste Izlaz, ali dopuštaju formule nuspojava i lanac izraza. Komponenta može imati svojstvo akcije pod nazivom AddRecord koje aplikaciji omogućuje dodavanje zapisa zbirci unutar komponente ili Reset akciju koja briše varijable ili zbirke unutar komponente.

U primjeru primjera klizača koji se ranije koriste za svojstvo Podaci možemo uvesti svojstvo akcije pod nazivom ResetValue za vraćanje klizača na zadanu vrijednost. Možemo koristiti formulu Reset( Slider1 ) za to. Sada se pojave naše komponente u aplikaciji mogu pozvati Component1.ResetValue() da se klizač vrati na zadanu vrijednost.

Svojstvo događaja

Postoje mnoga uobičajena svojstva vrste događaja, učinkovito svojstva funkcije ponašanja unosa, u standardnim kontrolama. OnSelect na kontroli gumba je najočitiji primjer. Komponenta može definirati bilo koji broj svojstava događaja, a te događaje nazvati funkcijom. Na primjer, komponenta koja ima kontrolu gumba može imati svojstvo događaja pod nazivom OnButtonClicked. U kontroli gumba OnSelect komponenta može pozvati svoje Component1.OnButtonClicked() svojstvo. Aplikacija koja troši tada može definirati vlastitu logiku za ovo svojstvo kako bi djelovala kada se pritisne gumb unutar komponente.

Zadane vrijednosti za svojstva ili argumente

Zadane vrijednosti mogu pružiti zadanu vrijednost za argument ili svojstvo u slučaju da nijedan nije postavljen. To nema smisla za neke vrste svojstava. Međutim, u nekim slučajevima mogu se koristiti za pružanje očekivane sheme za zapis. Pružanjem zadanog zapisa uspostavlja se vrsta zapisa kao očekivana shema.

Na primjer, svojstvo Akcija pod nazivom AddRecord prihvaća zapis koji će se dodati lokalnoj zbirci. Da bi pružio shemu očekivanog zapisa, proizvođač mora dodati zadanu vrijednost za argument ovog AddRecord svojstva.