Sdílet prostřednictvím


Ovládací prvek Karta v Power Apps

Poskytuje možnosti zobrazení a úprav pro jedno pole ovládacího prvku Zobrazit formulář nebo Upravit formulář.

Popis

Ovládací prvky Zobrazit formulář a Upravit formulář fungují jako kontejnery pro zobrazení celých záznamů. Každý kontejner může obsahovat sadu ovládacích prvků Karta, které zobrazují jednotlivá pole nebo je umožňují aktualizovat. Každá karta má vlastnost DataField určující, pro které pole záznamu má fungovat.

Pro různé datové typy a uživatelská rozhraní existují různé předdefinované karty. Například karta s ovládacím prvkem Textové zadání, který umožňuje zadat hodnotu číselného pole, se hodí pro zadávání pomocí klávesnice. Jiná karta může podporovat úpravu čísla pomocí ovládacího prvku Posuvník. Když vyberete ovládací prvek Form, můžete v pravém podokně snadno vybrat kartu podle požadovaného pole.

Karty samotné obsahují ovládací prvky. Ovládací prvky karty tvoří prostředí pro zobrazení a úpravy daného pole. Například karta čísla může obsahovat ovládací prvek Popisek pro zadání zobrazovaného názvu pole a ovládací prvek Textové zadání pro možnost měnit jeho hodnotu. Karta může mít i ovládací prvek Popisek pro zobrazení všech případných chyb ověření a ovládací prvek Popisek pro zadání hvězdičky označující, že toto pole je povinné.

Ovládací prvky předdefinované karty můžete přizpůsobit změnou jejich velikosti, jejich přesunutím, skrytím, přidáním ovládacích prvků a dalšími úpravami. Můžete si také zvolit zcela prázdnou kartu – Vlastní kartu – a přidat si na ni všechny ovládací prvky sami.

Předdefinované karty jsou ve výchozím nastavení uzamčené. U uzamčené karty je možné upravovat pouze některé její vlastnosti nebo ovládací prvky. Uzamčenou kartu nelze odstranit. Kartu můžete odemknout v zobrazení Upřesnit na kartě Zobrazení. Pokud je některá vlastnost uzamčená a nelze ji upravit, zobrazuje se vedle jejího názvu ikona zámku. Odemčení karty doporučujeme pouze pokročilým uživatelům – tuto možnost je potřeba využívat s rozvahou, protože po odemčení se pro kartu přestane automaticky generovat vzorec a kartu už nebude možné znovu uzamknout.

Na kontejneru formuláře je k dispozici záznam ThisItem, který obsahuje všechna pole záznamu. Například vlastnost karty Default je často nastavována na ThisItem.FieldName.

Můžete použít odkaz Parent (nadřízená položka), pokud chcete nakonfigurovat ovládací prvek odkazující na vlastnosti karty. Například k přečtení úvodního stavu pole ze zdroje dat by měl ovládací prvek použít hodnotu Parent.Default. Když použijete Parent místo toho, abyste k požadovaným informacím přistupovali přímo, bude karta lépe zapouzdřená a můžete ji použít pro jiné pole, aniž byste přerušili interní vzorce.

Příklady přizpůsobení, odemčení a vytváření karet najdete v tématu Principy datových karet.

Základní vlastnosti

DataField – název pole v záznamu, který tato karta umožňuje zobrazit a upravovat

  • Zadejte název jako jeden statický řetězec ve dvojitých uvozovkách (například "Name"), ne vzorec.
  • Zrušte vazbu karty tím, že nastavíte její vlastnost DataField na blank. Vlastnosti Valid a Update se u karet se zrušenou vazbou ignorují.

Default – počáteční hodnota ovládacího prvku před tím, než ji uživatel změní.

  • Pro každý ovládací prvek na kartě nastavte tuto vlastnost na Parent.Default, aby odkazovala na výchozí hodnotu pole v závislosti na zdroji dat. Parent.Default můžete nastavit například pro vlastnost posuvníku Default. Tím zajistíte, že uživatel u tohoto posuvníku začne na obecné hodnotě.

DisplayMode – k dispozici jsou hodnoty Edit, View a Disabled. Umožňuje povolit pro ovládací prvek na kartě zadávání uživatelem (Edit, Úpravy), pouze zobrazuje data (View, Prohlížení), nebo je zakázaný (Disabled, Zakázáno).

  • Konfigurace této vlastnosti, která je ve výchozím nastavení svázána s chováním formuláře, umožňuje použít stejnou kartu v režimu úprav i prohlížení.
  • V režimu View budou podřízené ovládací prvky, jako je Textové zadání, Rozevírací nabídka nebo Volič data, pouze zobrazovat textové hodnoty. Nebudou vykreslovat žádné interaktivní prvky ani dekorace.

DisplayName – popisný název pro pole ve zdroji dat

  • Tato metadata ze zdroje dat poskytuje funkce DataSourceInfo.
  • Ovládací prvky na kartě by měly prostřednictvím hodnoty Parent.DisplayName odkazovat na název pole.

Error – uživatelem zadaná chybová zpráva, která se zobrazí pro toto pole při selhání ověřování

  • Tato vlastnost je nastavena při zavolání funkce SubmitForm.
  • Tato zpráva popisuje problémy s ověřením na základě metadat zdroje dat a ověření konfigurace vlastnosti Required příslušné karty.

Required – určuje, zda musí karta v případě úpravy pole zdroje dat obsahovat hodnotu

  • Metadata ze zdroje dat poskytuje funkce DataSourceInfo.
  • Ovládací prvky na kartě by měly pomocí vlastnosti Parent.Required ověřovat, zda je příslušné pole karty povinné.

Update – hodnota, která se pro dané pole zapíše zpět do zdroje dat

  • Vzorec této vlastnosti použijte, pokud chcete hodnoty z ovládacích prvků pro úpravy umístěných na kartě zapsat zpět do zdroje dat. Vlastnost Update příslušné karty můžete například nastavit na Slider.Value, aby se ve zdroji dat aktualizovaly hodnoty z posuvníku umístěného na této kartě.

Width – vzdálenost mezi levým a pravým okrajem ovládacího prvku.

WidthFit – určuje, zda se ovládací prvek automaticky rozšíří ve vodorovném směru, aby se zaplnil volný prostor ovládacího prvku kontejneru, jako je například Upravit formulář. Pokud má tato vlastnost hodnotu true u více karet, rozdělí se prostor mezi ně. Další informace najdete v tématu Principy rozložení datových formulářů.

Další vlastnosti

BorderColor – barva ohraničení ovládacího prvku.

BorderStyle – styl ohraničení ovládacího prvku Solid (Plné), Dashed (Čárkované), Dotted (Tečkované) nebo None (Žádné).

BorderThickness – tloušťka ohraničení ovládacího prvku.

Fill – barva pozadí ovládacího prvku.

Height – vzdálenost mezi horním a dolním okrajem ovládacího prvku.

Valid – určuje, zda ovládací prvek Karta nebo Upravit formulář obsahuje platné položky připravené k odeslání do zdroje dat

Visible – možnost zobrazení nebo skrytí ovládacího prvku.

X – vzdálenost mezi levým okrajem ovládacího prvku a levým okrajem jeho nadřazeného kontejneru (nebo obrazovky, pokud se nadřazený kontejner nepoužívá). U ovládacího prvku Karta v kontejneru s více sloupci určuje tato vlastnost sloupec, v němž se karta nachází.

Y – vzdálenost mezi horním okrajem ovládacího prvku a horním okrajem jeho nadřazeného kontejneru (nebo obrazovky, pokud se nadřazený kontejner nepoužívá). U ovládacího prvku Karta v kontejneru s více řádky určuje tato vlastnost řádek, na kterém se karta nachází.

Příklady

Příklady najdete v tématech Principy datových karet a Principy rozložení datových formulářů.

Pokyny pro přístupnost

Barevný kontrast

Zajistěte adekvátní barevný kontrast mezi těmito vlastnostmi:

  • Fill a všechny podřízené ovládací prvky. Pokud třeba karta obsahuje Popisek a popisek má transparentní výplň, pak se Fill karty ve skutečnosti stane barvou pozadí pro popisek. Proto musí být odpovídající kontrast mezi vlastností Fill karty a vlastností Color (Barva) popisku.

Podpora pro čtení z obrazovky

  • Musí existovat DisplayName.

Poznámka

Můžete nám sdělit, jaké máte jazykové preference pro dokumentaci? Zúčastněte se krátkého průzkumu. (upozorňujeme, že tento průzkum je v angličtině)

Průzkum bude trvat asi sedm minut. Nejsou shromažďovány žádné osobní údaje (prohlášení o zásadách ochrany osobních údajů).