Proprietățile componentelor planșei de lucru (versiune preliminară)

Componentele Canvas permit producătorilor să creeze diferite tipuri de proprietăți pentru a transmite valori sau logica între componentă și aplicația care găzduiește componenta. Proprietățile sunt o parte esențială a creării de componente interactive și reutilizabile.

Cerințe preliminare

Înainte de a putea utiliza această funcție, trebuie să fie activată în setările aplicației.

1. Deschideți aplicația canvas pentru editare în Power Apps Studio. Pe bara de comandă, selectați Setări>Actualizări.

2. În fila Previzualizare , găsiți și activați setările Proprietăți îmbunătățite ale componentei .

Tipuri de proprietăți

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

1. Proprietățile datelor: proprietățile datelor se referă la date, cum ar fi o culoare sau o valoare de text. O proprietate Date poate fi setată să fie Intrare sau Ieșire, care indică dacă componenta furnizează date aplicației (la componenta furnizează date sau componenta de ieșire) (Intrare). Proprietățile de date sunt singurele proprietăți care participă la fluxul de date ale aplicației.
2. Proprietățile funcției: proprietățile funcției sunt legate de logică, cum ar fi efectuarea unui calcul pe baza unor parametri specifici sau modificarea textului. Proprietatea Function poate fi setată să fie Input sau Output, care indică dacă componenta oferă o funcție pe care aplicația o poate apela (Out>oferă funcția), componenta poate apela (Intrare). Proprietățile funcției nu participă la fluxul de date al unei aplicații și nu pot folosi variabile ale componentelor sau ale aplicației.
3. Proprietățile acțiunii: proprietățile acțiunii sunt un tip de proprietate care se ocupă de logică și se comportă ca o IeșireFuncție. Astfel, componenta are logica definită, iar acea logică poate folosi expresii înlănțuite și poate manipula colecții sau variabile („comportament”). De exemplu, o proprietate Clear()Action ar putea oferi o funcționalitate pe care o poate apela aplicația pentru a șterge unele valori din componentă sau o proprietate Save()Action care actualizează o sursă de date.
4. Proprietăți eveniment: Proprietățile evenimentului sunt o categorie de proprietăți care implică logică și funcționează ca o IntrareFuncție. Astfel, aplicația definește logica, pe care componenta o poate apela și acea logică poate folosi expresii înlănțuite și poate 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 valori implicite, culoarea textului, dimensiunea etc. Să ne uităm la un exemplu simplu în care dorim să punem la dispoziție proprietățile unui control din componentă aplicației de găzduire. În acest exemplu, componenta noastră se numește Component1. Vom pune un control glisor în interiorul componentei noastre. Vom avea o proprietate Intrare pentru a specifica culoarea din aplicația consumatoare și o proprietate Ieșire în care componenta poate spune aplicației care este valoarea curentă a glisorului. Următorul exemplu presupune că componenta dvs. conține un control Clider denumit Slider.

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

Apoi, selectați controlul Slider1Clider . Găsiți proprietatea ValueFill și în bara de formule, introduceți Component1.SliderColor. Component1 se referă la numele componentei noastre și SliderColor este numele proprietății pe care am adăugat-o anterior.

Acum componenta noastră are o proprietate SliderColor care poate fi setată în aplicația consumatoare, pentru a trece o culoare în componentă pentru a seta proprietatea ValueFill a glisorului.

De asemenea, dorim să oferim valoarea glisorului aplicației consumatoare. Pentru a realiza acest lucru, vom adăuga o proprietate Output .

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

Când o proprietate Date este Ieșire, componenta furnizează valoarea aplicației consumatoare. Pentru a seta formula pentru aceasta, trebuie să setăm noua proprietate SliderValue din componentă la proprietatea Valoare a glisorului.

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

Acum, proprietatea SliderValue a componentei noastre va reflecta valoarea glisorului din interiorul componentei, care poate fi apoi citită din aplicația consumatoare.

Proprietatea funcției

O proprietate de funcție conține o expresie care returnează o valoare. De obicei, funcția preia unele argumente pe care le folosește pentru a calcula sau determina valoarea de returnat.

O funcție Ieșire este o modalitate simplă de a crea o funcție personalizată pentru Power Apps. Componenta definește o funcție Output cu o expresie care preia unele argumente și returnează o valoare. Această funcție poate fi apoi utilizată într-o aplicație folosind numele componentei (să zicem Component1) apelând Component1.MyFunction(arg1, arg2).

O funcție Intrare este o modalitate prin care o aplicație consumatoare de a furniza logica unei componente, similar cu un indicator de funcție sau cu o funcție de apel invers. De exemplu, componenta dvs. poate să se ocupe de numele persoanelor și să aibă o funcție de intrare cu argumente firstname și lastname și respectă un șir înapoi. Aplicația ar putea defini expresia funcției de returnat $"{firstname} {lastname}" sau ar putea alege să definească o expresie pentru $"{lastname}, {firstname}". Componenta poate apela doar funcția furnizată de producătorul aplicației și poate utiliza șirul returnat.

Proprietate de acțiune

Proprietățile acțiunii sunt similare cu proprietățile funcției de tip Ieșire, dar permit formulele cu 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 exemplelor de glisor utilizate pentru proprietatea de date anterior, putem introduce o proprietate de acțiune numită ResetValue pentru a seta glisorul înapoi la valoarea sa implicită. Putem folosi formula Reset( Slider1 ) pentru aceasta. Acum, instanțe ale componentei noastre din aplicație pot apela Component1.ResetValue() pentru a seta glisorul înapoi la valoarea implicită.

Proprietatea evenimentului

Există multe proprietăți comune de tip Event, care introduc efectiv proprietăți ale funcției de comportament, în controalele standard. OnSelect de pe butonul de control este cel mai evident exemplu. O componentă poate defini orice număr de proprietăți de eveniment și poate apela aceste evenimente ca o funcție. De exemplu, o componentă care are un buton de control ar putea avea o proprietate de eveniment numită OnButtonClicked. În controlul butonului OnSelect componenta își poate apela Component1.OnButtonClicked() proprietatea. O aplicație consumatoare își poate defini apoi propria logică pentru această proprietate, pentru a acționa atunci când butonul din interiorul componentei este apăsat.

Valori implicite pentru proprietăți sau argumente

Valorile implicite pot furniza o valoare implicită pentru un argument sau proprietate în cazul în care nu este setată niciuna. Acest lucru nu are sens pentru anumite tipuri de proprietăți. Cu toate acestea, în unele cazuri, acestea pot fi utilizate pentru a furniza o schemă așteptată pentru o înregistrare. Prin furnizarea unei înregistrări implicite, se stabilește un tip de înregistrare ca schemă așteptată.

De exemplu, o proprietate Acțiune denumită AddRecord acceptă o înregistrare pentru a fi adăugată la o colecție locală. Pentru a furniza schema înregistrării așteptate, un producător trebuie să adauge o valoare implicită pentru argumentul acestei AddRecord proprietăți.