Vászonösszetevő tulajdonságai (kísérleti)

A vászonalapú összetevők lehetővé teszik a készítők számára, hogy különböző típusú tulajdonságokat hozzanak létre az összetevők vagy logika közötti értékek vagy logika továbbításához az összetevő és az összetevőt üzemeltető alkalmazás között. A tulajdonságok az interaktív és újrafelhasználható összetevők létrehozásának elengedhetetlen részét képezik.

A tulajdonságok típusai

A készítők számára négyféle tulajdonság áll rendelkezésre:

1. Adattulajdonságok: Az adattulajdonságok adatokra vonatkoznak, például színre vagy szöveges értékre. A Data tulajdonság beállítható bemenetre vagy kimenetre , ami azt jelzi, hogy az összetevő adatokat szolgáltat-e az alkalmazásnak (kimenet), vagy az alkalmazás szolgáltat-e adatokat az összetevőnek ( bemenet). Az adattulajdonságok az egyetlen olyan tulajdonságok, amelyek részt vesznek az alkalmazás adatfolyamában.
2. Függvénytulajdonságok: A függvénytulajdonságok logikához kapcsolódnak, például adott paramétereken alapuló számítás végrehajtásához vagy szöveg módosításához. A függvénytulajdonság beállítható bemenetre vagy kimenetre, ami azt jelzi, hogy az összetevő olyan függvényt biztosít-e, amelyet az alkalmazás meghívhat (kimenet ), vagy az alkalmazás olyan függvényt biztosít, amelyet az összetevő meghívhat ( bemenet). A függvénytulajdonságok nem vesznek részt az alkalmazás adatfolyamában, és nem használhatnak összetevő- vagy alkalmazásváltozókat.
3. Művelettulajdonságok: A művelettulajdonságok olyan típusú tulajdonságok, amelyek logikával foglalkoznak, és kimeneti függvényként viselkednek. Így az összetevő rendelkezik a logika meghatározásával, és ez a logika láncolt kifejezéseket használhat, és manipulálhatja a gyűjteményeket vagy változókat ("viselkedés"). Egy Clear() Action tulajdonság például olyan funkciókat biztosíthat, amelyeket az alkalmazás meghívhat az összetevő bizonyos értékeinek törléséhez, vagy egy adatforrást frissítő Action Save() tulajdonságot.
4. Eseménytulajdonságok: Az eseménytulajdonságok olyan tulajdonságkategóriák, amelyek logikát tartalmaznak, és bemeneti függvényként működnek. Így az alkalmazás meghatározza azt a logikát, amelyet az összetevő meghívhat, és ez a logika láncolt kifejezéseket használhat, és kezelheti a gyűjteményeket vagy változókat ("viselkedés"). Ezeknek a tulajdonságoknak a neve általában egy eseményt tükröz, például OnSelect vagy OnChanged.

Adattulajdonság

Az adattulajdonságok használata könnyen elképzelhető. Az alkalmazások szabványos vezérlői általában több adattulajdonsággal rendelkeznek az alapértelmezett értékek, a szöveg színe, mérete stb. beállításához. Nézzünk meg egy egyszerű példát, ahol az összetevőn belüli vezérlő tulajdonságait szeretnénk elérhetővé tenni az üzemeltető alkalmazás számára. Ebben a példában az összetevő neve Component1 van. Egy csúszka vezérlőt helyezünk az alkatrészünk belsejébe. Lesz egy Input tulajdonságunk a fogyasztó alkalmazás színének megadásához, és egy Output tulajdonságunk, ahol az összetevő meg tudja mondani az alkalmazásnak, hogy mi a csúszka aktuális értéke. Az alábbi példa feltételezi, hogy az összetevő tartalmaz egy nevű Csúszka vezérlőt Slider.

1. Az összetevő tulajdonságpaneljén válassza az Új egyéni tulajdonság lehetőséget.
2. Az Új egyéni tulajdonságpanelen írja be a megjelenítendő név Slider Color értéket.
3. Válassza az Adatok tulajdonságtípusa , majd a Bemenet tulajdonságdefiníciós érték lehetőséget.
4. Végül az Adattípus legördülő menüből válassza a Szín lehetőséget.
5. Kattintson a Létrehozás lehetőségre.

Ezután válassza ki a Csúszka Slider1 vezérlőt. Keresse meg a ValueFill tulajdonságát, és írja be Component1.SliderColor a szerkesztőlécbe. Component1 az összetevő nevére utal, és SliderColor a korábban hozzáadott tulajdonság neve.

Most az összetevőnknek van egy SliderColor tulajdonsága, amely beállítható a fogyasztó alkalmazásban, hogy színt adjon át az összetevőnek a csúszka ValueFill tulajdonságának beállításához.

A csúszka értékét is szeretnénk megadni a fogyasztó alkalmazásnak. Ehhez hozzáadunk egy Output tulajdonságot.

1. Az összetevő tulajdonságpaneljén válassza az Új egyéni tulajdonság lehetőséget.
2. Az Új egyéni tulajdonságpanelen írja be a megjelenítendő név értéket Slider Value.
3. Válassza az Adatok tulajdonságtípust, majd a Tulajdonságdefiníció értéke Kimenet lehetőséget .
4. Végül az Adattípus legördülő menüből válassza a Szám lehetőséget.
5. Kattintson a Létrehozás lehetőségre.

Ha egy Data tulajdonság kimenet , az összetevő biztosítja az értéket a felhasználó alkalmazásnak. Ennek képletének beállításához be kell állítanunk az összetevő új SliderValue tulajdonságát a csúszka Value tulajdonságára.

1. Az összetevő tulajdonságpaneljén kattintson a Slider Value tulajdonságra.
2. A szerkesztőlécen cserélje le az alapértelmezett értékét 100 a következő képletre: Slider1.Value

Most az SliderValue összetevő tulajdonsága tükrözi az összetevőn belüli csúszka értékét, amely ezután beolvasható a felhasználó alkalmazásból.

Függvény tulajdonság

A függvénytulajdonságok olyan kifejezést tartalmaznak, amely értéket ad vissza. A függvény általában néhány argumentumot vesz fel, amelyeket a visszaadandó érték kiszámításához vagy meghatározásához használ.

Az Output függvény egyszerű módja annak, hogy egyéni függvényt Power Apps hozzon létre. Az összetevő egy Output függvényt definiál egy kifejezéssel, amely néhány argumentumot vesz fel, és értéket ad vissza. Ez a függvény ezután használható egy alkalmazásban az összetevő nevével (mondjuk Component1) hívással Component1.MyFunction(arg1, arg2).

A bemeneti függvény egy módja annak, hogy egy fogyasztó alkalmazás logikát biztosítson egy összetevőnek, hasonlóan a függvénymutatóhoz vagy a visszahívási függvényhez. Előfordulhat például, hogy az összetevő személyek nevével foglalkozik, és rendelkezik egy argumentumokkal rendelkező firstname bemeneti függvénnyel, és lastname tiszteletben tartja a karakterláncot. Az alkalmazás meghatározhatja a visszaadandó $"{firstname} {lastname}" függvénykifejezést, vagy dönthet úgy, hogy definiál egy kifejezést $"{lastname}, {firstname}". Az összetevő egyszerűen meghívhatja az alkalmazáskészítő által megadott függvényt, és használhatja a visszaadott sztringet.

Művelet tulajdonság

A művelettulajdonságok hasonlóak a Kimenet típusú függvénytulajdonságokhoz, de lehetővé teszik a mellékhatásképleteket és a kifejezésláncolást. Egy összetevő rendelkezhet egy nevű művelettulajdonsággal AddRecord , amely lehetővé teszi az alkalmazás számára, hogy rekordot adjon hozzá az összetevőn belüli gyűjteményhez, vagy olyan Reset művelettel, amely törli az összetevőn belüli változókat vagy gyűjteményeket.

Az Adatok tulajdonsághoz korábban használt csúszkapéldák példájában bemutathatunk egy művelettulajdonságot, amely a csúszka alapértelmezett értékére való visszaállításához hívható ResetValue meg. Erre használhatjuk a képletet Reset( Slider1 ) . Mostantól az alkalmazás összetevőjének példányai meghívhatják Component1.ResetValue() , hogy visszaállítsák a csúszkát az alapértelmezett értékre.

Esemény tulajdonság

Számos gyakori eseménytípus-tulajdonság létezik, amelyek hatékonyan beviteli viselkedési függvénytulajdonságokat tartalmaznak a szabványos vezérlőkben. A gomb vezérlőelem OnSelect gombja a legnyilvánvalóbb példa. Egy összetevő tetszőleges számú eseménytulajdonságot definiálhat, és ezeket az eseményeket függvényként hívhatja meg. Például egy gomb vezérlőelemmel rendelkező összetevőnek lehet egy nevű eseménytulajdonsága OnButtonClicked. A gomb vezérlőelem OnSelect elemében az összetevő meghívhatja a tulajdonságát . Component1.OnButtonClicked() A felhasználó alkalmazás ezután meghatározhatja saját logikáját ehhez a tulajdonsághoz, hogy az összetevőn belüli gomb megnyomásakor működjön.

Tulajdonságok vagy argumentumok alapértelmezett értékei

Az alapértelmezett értékek alapértelmezett értéket biztosíthatnak egy argumentumhoz vagy tulajdonsághoz, ha nincs beállítva. Ennek nincs értelme bizonyos típusú tulajdonságok esetében. Bizonyos esetekben azonban felhasználhatók egy rekord várt sémájának biztosítására. Az alapértelmezett rekord megadásával egy rekordtípus jön létre várt sémaként.

Egy Action AddRecord nevű tulajdonság például elfogad egy rekordot egy helyi gyűjteményhez való hozzáadáshoz. A várt rekord sémájának megadásához a készítőnek hozzá kell adnia egy alapértelmezett értéket a AddRecord tulajdonság argumentumához.