A Kártya vezérlőelem a Power Apps alkalmazásokban

Megjelenítési és szerkesztési lehetőséget biztosít egy Display form vagy egy Edit form vezérlőelem egy mezőjéhez.

Ismertetés

Az Display form és az Edit form vezérlőelemek tárolóként szolgálnak teljes rekordok megjelenítéséhez és megtekintéséhez. Minden tároló több Kártya vezérlőelemet tartalmazhat, amelyek egyedi mezőket jelenítenek meg, vagy lehetővé teszik ezeknek a mezőknek a frissítését. Minden kártya rendelkezik DataField tulajdonsággal, amely meghatározza, hogy a kártya a mező melyik rekordját használja.

A különféle adattípusokhoz és felhasználói felületekhez előre meghatározott kártyák vannak meghatározva. Használható például olyan kártya, amely egy számmező egy Text input vezérlőelemmel való szerkesztésére szolgál, amely nagyszerűen használható a billentyűzettel. Egy másik kártya ehelyett támogathatja egy szám egy Slider vezérlőelemmel való szerkesztését. Ha ki van jelölve az űrlap vezérlőelem, akkor a jobb oldali panelen könnyen kiválaszthatja a kártyákat a mezők alapján.

A kártyák maguk is tartalmaznak vezérlőelemeket. A kártyák vezérlőelemeiből áll össze az egyetlen mezőre vonatkozó megjelenítési és szerkesztési felület. Egy számkártya például állhat egy Label vezérlőelemből, amely megjeleníti a mező megjelenített nevét, és egy Text input vezérlőelemből, amely szerkesztőt biztosít a mező értékéhez. A kártya ezenkívül rendelkezhet egy olyan Label vezérlőelemmel, amely megjeleníti az esetleges érvényesítési hibákat, és egy olyan Label vezérlőelemmel is, amely az általános csillag szimbólummal jelzi, hogy az adott mezőt kötelező megadni.

Az előre definiált kártyák vezérlőelemeit testre szabhatja azok átméretezésével, áthelyezésével, elrejtésével, vezérlőelemek hozzáadásával és egyéb módosításokkal. Kiindulhat egy teljesen üres kártyából, azaz „egyéni kártyából” is, amelyhez saját maga által létrehozott vezérlőelemeket adhat hozzá.

Az előre definiált kártyák alapértelmezés szerint zárolt állapotban vannak. A zárolt kártyák esetében csak a kártya vagy a kártya vezérlőelemeinek meghatározott tulajdonságai módosíthatók, és a zárolt kártyák nem törölhetők. A kártyazárolást a Speciális nézet Nézet lapján jelenítheti meg és oldhatja fel. Ha egy tulajdonság zárolva van és nem módosítható, akkor a neve mellett egy lakat ikon jelenik meg. A kártyák zárolásának feloldása csak gyakorlott felhasználók számára ajánlott, és körültekintően kell elvégezni, mivel ezután a rendszer már nem fogja automatikusan generálni az adott kártya képleteit, és a kártyákat nem lehet újból zárolni.

Az űrlap tárolójában rendelkezésre áll a ThisItem rekord, amely tartalmazza a rekord összes mezőjét. A kártya Alapértelmezés tulajdonsága például gyakran a ThisItem.FieldName értékre van beállítva.

A Fölérendelt hivatkozással konfigurálhat vezérlőelemeket úgy, hogy egy kártya tulajdonságaira hivatkozzanak. A mező kezdeti állapotának az adatforrásból való olvasására például a vezérlőnek a Parent.Default értéket kell használnia. Ha a kívánt információ közvetlen elérése helyett a Fölérendelt hivatkozást használja, akkor a kártya beágyazottabb lesz, és anélkül módosíthatja másik mezőre, hogy ennek hatására meghibásodnának a belső képletek.

A kártyák testreszabásáról, zárolásának feloldásáról és létrehozásáról az Az adatkártyák ismertetése című témakörben olvashat bővebben.

Fő tulajdonságok

DataField – Annak a mezőnek a neve a rekordban, amely a kártyán meg van jelenítve és szerkeszthető.

• A nevet egyetlen, idézőjelek között szereplő statikus sztringként (például "Név"), nem pedig képletként kell megadni.
• A kártya kötését a DataField tulajdonságának üres értékre való beállításával szüntetheti meg. A kötetlen kártyák esetében a rendszer nem veszi figyelembe az Érvényes és a Frissítés tulajdonságot.

Alapértelmezés – A vezérlőelem kezdeti értéke, mielőtt a felhasználó megváltoztatná azt.

• A kártya egyes vezérlőelemeinek ezen tulajdonságát állítsa a Parent.Default értékre a mező az adatforrásnak megfelelő alapértelmezett értékére való hivatkozáshoz. Egy csúszka Alapértelmezett tulajdonságának a Parent.Default értékre való beállításával például biztosíthatja, hogy a felhasználó a csúszka egy általános értékével kezdjen.

DisplayMode (Megjelenítési mód) – Az értéke Szerkesztés, Megtekintés vagy Letiltva lehet. A tulajdonság azt szabályozza, hogy a kártya vezérlőeleme lehetővé teszi-e a felhasználói adatbevitelt (Szerkesztés), csak megjeleníti az adatokat (Megtekintés), vagy le van tiltva (Letiltva).

• A tulajdonság beállításával, amely alapértelmezés szerint az űrlap viselkedéséhez van kötve, lehetséges egyetlen kártya használata a szerkesztési és a megtekintési űrlapokhoz is.
• A Megtekintés módban az olyan alárendelt vezérlőelemek, mint például a Text input, a Drop down és a Date Picker, csak a szöveges értéket fogják renderelni, az interaktív elemeket és a dekorációkat nem.

DisplayName – Egy adatforrásban lévő mező felhasználóbarát neve.

• A DataSourceInfo függvény az adatforrásból biztosítja ezeket a metaadatokat.
• A kártyán belüli vezérlőelemeknek a Parent.DisplayName értéket kell használniuk a mező nevére való hivatkozáshoz.

Hiba – A mezőhöz sikertelen érvényesítéskor megjelenített felhasználóbarát hibaüzenet.

• A tulajdonságot a SubmitForm függvény meghívásakor állítja be a rendszer.
• Az üzenet az adatforrás metaadatai és a kártya Kötelező tulajdonságának ellenőrzése alapján írja le az érvényesítési hibákat.

Kötelező – Azt határozza meg, hogy egy kártyának, amelyen egy adatforrás egy mezője szerkeszthető, tartalmaznia kell-e értéket.

• A DataSourceInfo függvény az adatforrásból biztosítja a szükséges metaadatokat.
• A kártya vezérlőelemeinek a Parent.Required értéket kell használniuk annak meghatározásához, hogy kötelező-e kitölteni a kártya mezőjét.

Frissítés – Egy mező adatforrásába visszaírandó érték.

• Ezen tulajdonság képletével kérheti le az értékeket a kártya beviteli mezőiből az adatforrásba való visszaíráshoz. Egy kártya Frissítés tulajdonságát beállíthatja például a Slider.Value értékre az adatforrás a kártya csúszkájából származó értékkel való frissítéséhez.

Szélesség – Egy vezérlőelem bal és jobb széle közötti távolság.

WidthFit – Azt határozza meg, hogy automatikusan megnövekedjen-e egy vezérlőelem szélessége egy tároló vezérlőelem, például egy Edit form vezérlőelem üres területének kitöltéséhez. Ha ez a tulajdonság több kártyánál is true (igaz) értékre van beállítva, az üres hely megoszlik közöttük. További információt az Understand data form layout (Az adatűrlapok elrendezésének ismertetése) című témakörben találhat.

További tulajdonságok

BorderColor – Egy vezérlőelem szegélyének színe.

BorderStyle – Azt határozza meg, hogy egy vezérlőelem szegélye Folytonos, Szaggatott, Pontozott, vagy Nincs értékű.

BorderThickness – Egy vezérlőelem szegélyének vastagsága.

Kitöltés – Egy vezérlőelem háttérszíne.

Magasság – Egy vezérlőelem felső és alsó széle közötti távolság.

Érvényes – Azt határozza meg, hogy egy Kártya vagy Edit form vezérlőelem az adatforrásnak való küldésre kész, érvényes bejegyzéseket tartalmaz-e.

Látható – Azt határozza meg, hogy egy vezérlőelem látható vagy rejtett legyen.

X – A távolság egy vezérlőelem bal oldali szegélye és a fölérendelt tároló bal oldali szegélye között (vagy a képernyő széle között, ha nincs fölérendelt tároló). Az olyan Card vezérlőelemeknél, melyek több oszloppal rendelkező tárolóban találhatók, ez a tulajdonság határozza meg az oszlopot, amelyben a kártya megjelenik.

Y – A távolság egy vezérlőelem felső szegélye és a fölérendelt tároló felső szegélye között (vagy a képernyő széle között, ha nincs fölérendelt tároló). Az olyan Card vezérlőelemnél, amely több sorral rendelkező tárolóban van, ez a tulajdonság azt a sort határozza meg, amelyben a kártya megjelenik.

Példák

Példákat az Az adatkártyák ismertetése és az Az adatűrlapok elrendezésének ismertetése című témakörben találhat.

Akadálymentességi irányelvek

Színkontraszt

Az alábbi elemek között megfelelő mértékű színkontrasztnak kell lennie:

• Kitöltés és bármely alárendelt vezérlőelem. Ha egy kártya például tartalmaz egy Label vezérlőelemet, és a címke átlátszó kitöltésű, akkor lényegében a kártya Kitöltés tulajdonsága lesz a címke háttérszíne. Emiatt megfelelő kontrasztnak kell lennie a kártya Kitöltés tulajdonsága és a címke Szín tulajdonsága között.

Képernyőolvasó támogatása

• A DisplayName tulajdonságnak jelen kell lennie.

Megjegyzés

Megosztja velünk a dokumentációja nyelvi preferenciáit? Rövid felmérés elvégzése. (ne feledje, hogy ez a felmérés angol nyelvű)

A felmérés elvégzése körülbelül hét percet vesz igénybe. Semmilyen személyes adatot nem gyűjtünk (adatvédelmi nyilatkozat).