Ovládací prvok Karta v Power Apps

Poskytuje možnosti zobrazenia a úpravy pre jedno pole ovládacieho prvku Display form alebo Edit form.

Popis

Ovládacie prvky Display form a Edit form fungujú ako kontajnery na zobrazovanie celých záznamov. Každý kontajner môže obsahovať množinu ovládacích prvkov Karta, ktoré zobrazujú jednotlivé polia alebo poskytujú spôsob aktualizácie týchto polí. Každá karta má vlastnosť DataField určujúcu, pre ktoré pole v zázname má fungovať.

Pre rôzne typy údajov a používateľských rozhraní existujú rôznym spôsobom preddefinované karty. Napríklad môže existovať karta na úpravu číselného poľa pomocou ovládacieho prvku Text input, ktorá je vhodná na použitie s klávesnicou. Ďalšia karta môže namiesto toho podporovať úpravu čísla pomocou ovládacieho prvku Slider. Keď vyberiete ovládací prvok formulára, môžete v pravej table jednoduchým spôsobom vybrať kartu podľa požadovaného poľa.

Samotné karty obsahujú ovládacie prvky. Ovládacie prvky karty tvoria prostredie na zobrazenie a úpravu daného poľa. Napríklad karta čísla môže obsahovať ovládací prvok Label na zadávanie a zobrazenie názvu poľa a ovládací prvok Text input s možnosťami meniť jeho hodnotu. Karta tiež môže obsahovať ovládací prvok Label na zobrazenie prípadných chýb overenia a ovládací prvok Label na zadanie hviezdičky označujúcej, že toto pole je povinné.

Ovládacie prvky preddefinovanej karty si môžete prispôsobiť zmenou ich veľkosti, ich premiestnením, skrytím, pridaním ovládacích prvkov a inými úpravami. Môžete tiež začať s úplne prázdnou kartou – vlastnou kartou – do ktorej si pridáte ovládacie prvky sami.

V predvolenom nastavení sú preddefinované karty uzamknuté. V uzamknutej karte môžete upravovať iba určité vlastnosti karty alebo ovládacích prvkov v nej a uzamknutú kartu nemôžete ani odstrániť. Zámok karty môžete zobraziť a odomknúť iba v zobrazení Spresniť na karte Zobrazenie. Ak je vlastnosť uzamknutá a nedá sa upravovať, vedľa jej názvu je zobrazená ikona zámku. Odomknutie karty odporúčame iba pokročilým používateľom a malo byť vykonané s rozvahou, pretože sa v nej prestane automaticky generovať vzorec a karta sa nebude dať znova uzamknúť.

V kontajneri formulára bude dostupný záznam ThisItem, ktorý obsahuje všetky polia záznamu. Napríklad vlastnosť karty Default sa často nastavuje na ThisItem.FieldName.

Ak chcete nakonfigurovať ovládací prvok odkazujúci na vlastnosti karty, môžete použiť odkaz Parent. Napríklad ovládací prvok by mal použiť hodnotu Parent.Default na prečítanie počiatočného stavu poľa zo zdroja údajov. Ak použijete Parent namiesto toho, aby ste k požadovaným údajom pristúpili priamo, karta bude lepšie zapuzdrená a budete ju môcť použiť pre iné pole bez toho, aby ste prerušili interné vzorce.

Príklady prispôsobenia, odomykania a vytvárania kariet nájdete v článku Princípy údajových kariet.

Základné vlastnosti

DataField – názov poľa v zázname, ktorý táto karta umožňuje zobraziť a upraviť.

• Zadajte názov ako jeden statický reťazec v dvojitých úvodzovkách (napríklad "Name"), nie vzorec.
• Zrušte väzbu karty tým, že nastavíte vlastnosť DataField na blank. Vlastnosti Valid a Update sa v prípade kariet so zrušenou väzbou ignorujú.

Default – počiatočná hodnota ovládacieho prvku skôr, než ju používateľ zmení.

• Pre každý ovládací prvok karty nastavte túto vlastnosť na Parent.Default, aby odkazovala na predvolenú hodnotu poľa v závislosti od zdroja údajov. Parent.Default môžete napríklad nastaviť pre vlastnosť jazdca Default, čím zaistíte, že používateľ tohto jazdca začne so všeobecnou hodnotou.

DisplayMode – k dispozícii sú hodnoty Edit, View, a Disabled. Určuje, či ovládací prvok v karte umožňuje vstup používateľa (Edit, Úpravy), iba zobrazuje údaje (View, Zobrazenie) alebo je zakázaný (Disabled, Zakázané).

• Konfigurácia tejto vlastnosti, ktorá je v predvolenom nastavení zviazaná so správaním formulára, umožňuje použiť túto kartu zároveň v režime úprav i v režime zobrazenia.
• V režime View budú podriadené ovládacie prvky, akými sú Text input, Drop down a Date Picker, iba zobrazovať textové hodnoty. Nebudú vykresľovať žiadne interaktívne prvky ani dekorácie.

DisplayName – popisný názov poľa v zdroji údajov.

• Tieto metaúdaje zo zdroja údajov poskytuje funkcia DataSourceInfo.
• Ovládacie prvky v karte by mali prostredníctvom hodnoty Parent.DisplayName odkazovať na názov poľa.

Error – popisná chybová správa, ktorá sa zobrazí pre to pole, v ktorom zlyhalo overovanie.

• Táto vlastnosť sa nastaví pri volaní funkcie SubmitForm.
• Táto správa popisuje problémy s overovaním na základe metaúdajov zo zdroja údajov a kontroly konfigurácie vlastnosti Required danej karty.

Required – určuje, či musí karta v prípade úpravy poľa zdroja údajov obsahovať hodnotu.

• Funkcia DataSourceInfo poskytuje požadované metaúdaje zo zdroja údajov.
• Ovládacie prvky v karte by mali pomocou vlastnosti Parent.Required overiť, či je príslušné pole karty povinné.

Update – hodnota, ktorú sa pre dané pole zapíše späť do zdroja údajov.

• Vzorec tejto vlastnosti používajte, ak chcete hodnoty z ovládacích prvkov pre úpravy nachádzajúcich sa v karte zapísať späť do zdroja údajov. Môžete napríklad vlastnosť karty Update nastaviť na hodnotu Slider.Value, aby sa zdroj údajov mohol aktualizovať hodnotou jazdca tejto karty.

Width – vzdialenosť medzi ľavým a pravým okrajom ovládacieho prvku.

WidthFit – určuje, či sa ovládací prvok automaticky roztiahne vo vodorovnom smere, aby vyplnil prázdne miesto v ovládacom prvku kontajnera, ako je napríklad ovládací prvok Edit form. Ak má viac kariet nastavených túto vlastnosť na hodnotu true, priestor sa medzi nimi rozdelí. Ďalšie informácie nájdete v článku Princípy rozloženia údajových formulárov.

Ďalšie vlastnosti

BorderColor – farba orámovania ovládacieho prvku.

BorderStyle – štýl orámovania ovládacieho prvku Solid (Plné), Dashed (Prerušované), Dotted (Bodkované) alebo None (Žiadne).

BorderThickness – hrúbka orámovania ovládacieho prvku.

Fill – farba pozadia ovládacieho prvku.

Height – vzdialenosť medzi horným a dolným okrajom ovládacieho prvku.

Valid – určuje, či ovládací prvok Karta alebo Edit form obsahuje platné položky pripravené na odoslanie do zdroja údajov.

Visible – možnosť zobrazenia alebo skrytia ovládacieho prvku.

X – vzdialenosť medzi ľavým okrajom ovládacieho prvku a ľavým okrajom jeho nadradeného kontajnera (alebo obrazovky, ak sa nadradený kontajner nepoužíva). V prípade ovládacieho prvku Card obsahujúceho viac stĺpcov určuje táto vlastnosť stĺpec, v ktorom sa karta nachádza.

Y – vzdialenosť medzi horným okrajom ovládacieho prvku a horným okrajom jeho nadriadeného kontajnera (alebo obrazovky, ak sa nadradený kontajner nepoužíva). V prípade ovládacieho prvku Card obsahujúceho viac stĺpcov určuje táto vlastnosť riadok, v ktorom sa karta nachádza.

Príklady

Príklady nájdete v článkoch Princípy údajových kariet a Princípy rozloženia údajových formulárov.

Pokyny na zjednodušenie ovládania

Farebný kontrast

Dostatočný farebný kontrast musí byť medzi:

• Fill s ľubovoľnými podradenými ovládacími prvkami. Ak napríklad karta obsahuje vlastnosť Label a označenie má priehľadnú výplň, vlastnosť Fill karty sa stane farbou pozadia pre označenie. Medzi vlastnosťou Fill karty a vlastnosťou Color označenia preto musí byť adekvátny kontrast.

Podpora čítača obrazovky

• Musí existovať vlastnosť DisplayName.

Poznámka

Môžete nás informovať o svojich voľbách jazyka pre dokumentáciu? Absolvujte krátky prieskum. (upozorňujeme, že tento prieskum je v angličtine)

Prieskum bude trvať približne sedem minút. Nezhromažďujú sa žiadne osobné údaje (vyhlásenie o používaní osobných údajov).