Proprietățile componentei Canvas

Componentele Canvas permit creatorilor să creeze diferite tipuri de proprietăți pentru a transmite valori sau logică între componentă și aplicația care găzduiește componenta. Proprietățile sunt esențiale pentru construirea de componente interactive și reutilizabile.

Cerințe preliminare

Această funcție este activată în mod implicit pentru aplicațiile noi. Pentru aplicațiile existente, trebuie să activați această funcție în setările aplicației.

1. Deschideți aplicația *canvas* pentru editare . Power Apps Studio În bara de comenzi, selectați Setări>Actualizări.

2. În fila Nou , găsiți și activați setarea Proprietăți îmbunătățite ale componentelor .

Tipuri de proprietăți

Există patru tipuri de proprietăți disponibile pentru producători.

1. Proprietăți ale datelor: Proprietățile datelor se referă la date, cum ar fi o culoare sau o valoare a textului. O proprietate Data poate fi setată să fie Input sau Output, care indică dacă componenta furnizează date aplicației (Output) sau aplicația furnizează date componentei (Input). Proprietățile de date sunt singurele proprietăți care participă la fluxul de date al aplicației.
2. Proprietăți ale funcțiilor: Proprietățile funcțiilor sunt legate de logică, cum ar fi efectuarea unui calcul pe baza unor parametri specifici sau modificarea textului. O proprietate Function poate fi setată să fie Input sau Output, care indică dacă componenta oferă o funcție pe care aplicația o poate apela (Output) sau dacă aplicația oferă o funcție pe care componenta o poate apela (Input). Proprietățile funcției nu participă la fluxul de date al unei aplicații și nu pot utiliza variabile de componentă sau de aplicație.
3. Proprietăți ale acțiunilor: Proprietățile acțiunilor sunt un tip de proprietate care se ocupă de logică și se comportă ca o Funcție de ieșire. Astfel, componenta are logica definită, iar acea logică poate utiliza expresii înlănțuite și poate manipula colecții sau variabile („comportament”). De exemplu, o proprietate Clear()Action ar putea oferi funcționalități pe care aplicația le poate apela pentru a șterge anumite valori din componentă sau o proprietate Save()Action care actualizează o sursă de date.
4. Proprietăți de eveniment: Proprietățile de eveniment sunt o categorie de proprietăți care implică logică și funcționează ca o funcție de intrare. Astfel, aplicația definește logica pe care componenta o poate apela și care poate utiliza expresii înlănțuite și manipula colecții sau variabile („comportament”). De obicei, numele acestor proprietăți reflectă un eveniment precum OnSelect sau OnChanged.

Proprietatea datelor

Utilizarea unei proprietăți de date este ușor de imaginat. Controalele standard din aplicații au de obicei mai multe proprietăți de date, pentru a seta valorile implicite, culoarea textului, dimensiunea etc. Să luăm un exemplu simplu în care doriți să faceți ca proprietățile unui control din cadrul componentei să fie disponibile pentru aplicația de găzduire. În acest exemplu, componenta este denumită Component1. Puneți un control glisant în interiorul componentei. Adăugați o proprietate Input pentru a specifica culoarea din aplicația consumatoare și o proprietate Output pentru ca componenta să poată comunica aplicației valoarea curentă a cursorului. Acest exemplu presupune că componenta are un control Slider numit Slider.

1. În panoul de proprietăți al componentei, selectați Proprietate personalizată nouă.
2. În panoul Proprietate personalizată nouă , introduceți numele afișat Slider Color.
3. Selectați Tipul de proprietate din Date și selectați Definiția proprietății valoarea Intrare.
4. În cele din urmă, din meniul derulant Tip de date , selectați Culoare.
5. Faceți clic pe Creați.

Apoi, selectați controlul Slider1Slider . Găsiți proprietatea sa ValueFill și în bara de formule, introduceți Component1.SliderColor. Component1 este numele componentei, iar SliderColor este numele proprietății pe care ați adăugat-o.

Acum componenta are o proprietate SliderColor care poate fi setată în aplicația consumatoare pentru a transmite o culoare componentei și a seta proprietatea ValueFill a cursorului.

De asemenea, ați putea dori să furnizați valoarea cursorului aplicației consumatoare. Pentru a face acest lucru, adăugați o proprietate Output .

1. În panoul de proprietăți al componentei, selectați Proprietate personalizată nouă.
2. În panoul Proprietate personalizată nouă , introduceți numele afișat Slider Value.
3. Selectați Tipul de proprietate de Date și selectați Definiția proprietății valoarea Ieșire.
4. În cele din urmă, din meniul derulant Tip de date , selectați Număr.
5. Faceți clic pe Creați.

Când o proprietate *Data* este *Output*, componenta furnizează valoarea aplicației consumatoare. Pentru a seta formula, setați proprietatea new SliderValue din componentă la proprietatea Value a cursorului.

1. În panoul de proprietăți al componentei, faceți clic pe proprietatea Slider Value .
2. În bara de formule, înlocuiți valoarea implicită 100 cu următoarea formulă: Slider1.Value.

Acum, proprietatea componentei SliderValue reflectă valoarea cursorului din interiorul componentei, pe care aplicația consumatoare o poate citi.

Proprietatea funcției

O proprietate a unei funcții conține o expresie care returnează o valoare. De obicei, funcția primește argumente pe care le folosește pentru a calcula valoarea de returnat.

Notă

Proprietățile funcțiilor nu pot accesa în prezent variabile sau valori și proprietăți ale componentelor și nu pot declanșa fluxul de date. Orice valori necesare trebuie transmise ca argumente.

O funcție Output este o modalitate simplă de a crea o funcție personalizată pentru Power Apps. Componenta definește o funcție de ieșire cu o expresie care primește anumite argumente și returnează o valoare. Această funcție poate fi apoi utilizată într-o aplicație folosind numele componentei (de exemplu, Component1) prin apelarea funcției Component1.MyFunction(arg1, arg2).

O funcție *Input* permite unei aplicații consumatoare să furnizeze logică unei componente, similar unui pointer de funcție sau unei funcții de apel invers. De exemplu, dacă componenta lucrează cu nume de persoane, poate avea o funcție de intrare cu argumente firstname și lastname și așteaptă un șir de caractere înapoi. Aplicația poate defini expresia funcției pentru a returna $"{firstname} {lastname}" sau $"{lastname}, {firstname}". Componenta apelează funcția furnizată de creatorul aplicației și utilizează șirul returnat.

Proprietatea acțiunii

Proprietățile acțiunilor sunt similare cu proprietățile funcțiilor de tip Output, dar permit formule de efecte secundare și înlănțuirea expresiilor. O componentă poate avea o proprietate de acțiune numită AddRecord care permite aplicației să adauge o înregistrare la o colecție din interiorul componentei sau o Reset acțiune care șterge variabilele sau colecțiile din interiorul componentei.

În exemplul anterior de slider pentru proprietatea Data, puteți adăuga o proprietate de acțiune numită ResetValue pentru a reseta sliderul la valoarea implicită. Folosește formula Reset( Slider1 ) pentru aceasta. Acum, instanțele componentei din aplicație pot apela Component1.ResetValue() pentru a reseta cursorul la valoarea implicită.

Proprietatea evenimentului

Multe controale standard au proprietăți de tip comun Event, care sunt proprietăți ale funcției de comportament de intrare. OnSelect pe butonul de control este un exemplu comun. O componentă poate defini proprietăți ale evenimentelor și poate apela aceste evenimente ca o funcție. De exemplu, o componentă cu un control buton poate avea o proprietate de eveniment numită OnButtonClicked. În proprietatea OnSelect a controlului buton, componenta poate apela proprietatea sa Component1.OnButtonClicked() . O aplicație consumatoare își poate defini propria logică pentru ca această proprietate să acționeze atunci când butonul din interiorul componentei este apăsat.

Valori implicite pentru proprietăți sau argumente

Valorile implicite dau o valoare unui argument sau unei proprietăți dacă nu este setată nicio valoare. Acest lucru nu are sens pentru anumite tipuri de proprietăți. În unele cazuri, puteți utiliza valori implicite pentru a afișa schema așteptată pentru o înregistrare. Prin furnizarea unei înregistrări implicite, setați tipul de înregistrare ca fiind schema așteptată.

De exemplu, o proprietate Action numită AddRecord preia o înregistrare pentru a o adăuga la o colecție locală. Pentru a afișa schema înregistrării așteptate, adăugați o valoare implicită pentru argumentul proprietății AddRecord .