Ovládací prvok Galéria v Power Apps

Ovládací prvok, ktorý obsahuje ďalšie ovládacie prvky a zobrazuje množinu údajov.

Popis

Ovládací prvok Galéria dokáže zobraziť viaceré záznamy zo zdroja údajov, pričom každý záznam môže obsahovať viaceré typy údajov. Ovládací prvok Galéria môžete použiť napríklad na zobrazenie niekoľkých kontaktov, kde každá položka bude zobrazovať kontaktné informácie s menom, adresou a telefónnym číslom jednotlivých kontaktov.

Každé údajové pole sa zobrazuje v samostatnom ovládacom prvku v rámci ovládacieho prvku Galéria. A tieto ovládacie prvky môžete nakonfigurovať vo svojej šablóne. Šablóna sa zobrazí ako prvá položka v galérii:

• Na ľavom okraji ovládacieho prvku Galéria ovládanie v orientácii na šírku.
• A na vrchole ovládacieho prvku Galéria ovládanie v orientácii na výšku.

Všetky zmeny vykonané v šablóne sa prejavia vnútri ovládacieho prvku Galéria.

Sú dostupné preddefinované šablóny na zobrazovanie obrázkov a textu v galérii, a galéria pre položky s premennou výškou.

Obmedzenia

Ovládanie galérie má tieto obmedzenia:

1. Ak používateľ posúva ovládacím prvkom Flexibilná výška pred načítaním všetkých položiek v galérii, môžete položku, ktorá je aktuálne zobrazená, po dokončení načítania údajov posúvať smerom nadol a mimo zobrazenia. Ak sa chcete tomuto problému vyhnúť, použite štandardný ovládací prvok Galéria namiesto verzie Flexibilná výška.
2. Nasledujúce ovládacie prvky nie sú v galérii podporované:
   • Display form
   • Formulár na úpravy
   • Zobrazovač PDF
   • Power BI dlaždic
   • Rich text editor
   • Posúvateľná obrazovka (tekutá mriežka)
   • Webový skener čiarových kódov
3. Do inej galérie môžete pridať iba jednu galériu.
4. Minimálna veľkosť TemplateSize je jedna. To môže spôsobiť, že ovládacie prvky v Galérii sa odchýlia od očakávaných X alebo Y hodnoty, keď neberiete do úvahy veľkosť šablóny.
5. Ak automaticky vytvoríte z údajov aplikáciu, uložíte ju a opätovne ju otvoríte, galéria prehľadávania nemusí hneď zobrazovať údaje. Ak chcete tento problém vyriešiť, zadajte do vyhľadávacieho poľa aspoň jeden znak a potom odstráňte zadaný text. V galérii sa potom zobrazia údaje podľa očakávania.
6. Ak galéria obsahuje ovládací prvok ComboBox, DatePicker, Slider alebo Toggle s pravidlom OnChange , ktoré opravuje rovnaké zdroj údajov alebo kolekciu ako galéria, môže to viesť k neočakávanému alebo zníženému výkonu. Je to preto, že pravidlo OnChange , ktoré záplatuje zdroj údajov galérie, môže vytvoriť nekonečný cyklus záplat a opätovného načítania. Ak sa chcete tomuto problému vyhnúť, odporúča sa nepoužívať OnChange pravidlá, keď sú tieto ovládacie prvky umiestnené v galérii.

Vlastnosti kľúča

Default – Položka alebo záznam zo zdroja údajov, ktoré sa majú vybrať pri spustení aplikácie.

Items – zdroj údajov zobrazený v ovládacích prvkoch ako je galéria, zoznam alebo graf.

Selected – vybratá položka.

Ďalšie vlastnosti

AccessibleLabel – Štítok galérie (nie položky, ktoré obsahuje) pre čítačky obrazovky. Mal by popisovať zoznam položiek.

AllItems – Položky, ktoré sú načítané v galérii. Môže to byť menej ako skutočný počet Položiek v zdroj údajov. Pri posúvaní galérie sa môžu načítať ďalšie položky. AllItems obsahuje aj ovládacie prvky, ktoré sa používajú v každej položke galérie.

AllItemsCount - Počet položiek, ktoré sú načítané v galérii. Môže to byť menej ako skutočný počet Položiek v zdroj údajov. Pri posúvaní galérie sa môžu načítať ďalšie položky.

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.

DelayItemLoading – oneskorenie načítania položiek (riadkov) až po prvom načítaní obrazovky.

DisplayMode – údaj o tom, či ovládací prvok umožňuje vstup používateľa (Edit), iba zobrazuje údaje (View) alebo je zakázaný (Disabled).

Fill – farba pozadia ovládacieho prvku.

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

ItemAccessibleLabel – Menovka každej položky galérie pre čítačky obrazovky. Mala by opísať, čo je každá položka.

LoadingSpinner (Žiadne, Ovládacie prvky alebo Údaje) – Ak je vybrané Žiadne, spinner sa nezobrazí. Ak je vybrané Ovládacie prvky | Údaje, číselník sa zobrazí, keď dôjde k vykresleniu, ktoré vedie k viditeľným prázdnym riadkom.

LoadingSpinnerColor – Farba výplne spinnera načítania. Predvolene je nastavený na hodnotu BorderColor.

NavigationStep – vzdialenosť posunutia galérie, keď je vlastnosť ShowNavigation nastavená na hodnotu pravda a používateľ vyberie na jednom konci galérie navigačnú šípku.

Selectable – Či je možné vybrať položky galérie. Ak je nastavená na pravda, čítačky obrazovky identifikujú galériu ako voliteľný zoznam. A vy vyberiete položku jej výberom. Ak je nastavená na nepravda, čítačky obrazovky identifikujú galériu ako bežný zoznam a výber položky ju nevyberie.

ShowNavigation – možnosť zobrazenia šípky na každom konci galérie, aby používateľ mohol prechádzať medzi položkami v galérii výberom šípky.

ShowScrollbar – možnosť zobrazenia posúvača pri ukázaní myšou na galériu.

TemplateFill – farba pozadia galérie.

TemplatePadding – vzdialenosť medzi položkami v galérii.

TemplateSize – Výška šablóny pre galériu v orientácii na výšku. Alebo šírka šablóny pre galériu v orientácii na šírku. Minimálna veľkosť je jedna.

Transition – vizuálny efekt (Pop (Vytlačenie), Push (Zatlačenie) alebo None (Žiadny)) keď používateľ ukáže myšou na položku v galérii.

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

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

WrapCount – počet zobrazených položiek v riadku alebo stĺpci podľa orientácie na šírku alebo na výšku.

X – Vzdialenosť medzi ľavým okrajom ovládacieho prvku a ľavým okrajom jej nadradeného kontajnera alebo obrazovky.

Y – Vzdialenosť medzi horným okrajom ovládacieho prvku a ľavým okrajom jej nadradeného kontajnera alebo obrazovky.

Súvisiace funkcie

Filter( ZdrojÚdajov, Vzorec )

Reset( Ovládací prvok ) – obnoví pôvodné nastavenie galérie. Počiatočný stav zahŕňa posun na prvú položku a výber prvej položky alebo predvoleného nastavenia, ak je k dispozícii.

Poznámka

Ovládací prvok Reset neresetuje rekurzívne všetky podradené prvky v galérii.

Príklady

Zobrazenie a filtrovanie údajov

• Zobrazenie textu
• Zobraziť obrázky
• Filtrovanie údajov výberom možnosti v zozname
• Filtrovanie údajov úpravou jazdca

Získanie údajov od používateľa

• Získanie textu
• Získanie obrázkov
• Získanie fotografií
• Získanie zvukov
• Získanie kresieb

Pokyny na zjednodušenie ovládania

Farebný kontrast

Ak sa má položka galérie vybrať kliknutím kamkoľvek na položku, zaistite dostatočný farebný kontrast medzi:

• BorderColor a farbou mimo galérie (ak existuje orámovanie).
• Fill a farbou mimo galérie (ak neexistuje orámovanie).

Podpora čítača obrazovky

• Musí byť k dispozícii vlastnosť AccessibleLabel.

  Poznámka

  Čítačky obrazovky oznámia, keď sa položky v galérii zmenia. Uvedú aj vlastnosť AccessibleLabel. Poskytne sa tým kontext k oznámeniu, ktorý je obzvlášť dôležitý v prípade, že sa na tej istej obrazovke nachádza viacero galérií.

• Ak položka galérie obsahuje viac ovládacích prvkov, použite ItemAccessibleLabel na zobrazenie obsahu položiek galérie.

• Nastavte hodnotu Voliteľný na pravda, ak chcete, aby používatelia vybrali položku galérie. V opačnom prípade nastavte túto hodnotu na nepravda.

• Ak položka galérie obsahuje viac ovládacích prvkov, použite ItemAccessibleLabel na poskytnutie zhrnutia obsahu položky galérie.

• Vlastnosť Selectable by mala byť nastavená primerane v závislosti od toho, či majú používatelia vybrať položku galérie.

Podpora klávesnice

• Zvážte nastavenie vlastnosti ShowScrollbar na hodnotu pravda. Na väčšine zariadení s dotykovou obrazovkou sa posúvač nezobrazí, kým používateľ nezačne posúvať obsah.

• Ak sa má položka galérie vybrať kliknutím kamkoľvek na položku, musí existovať aj spôsob, ako položku galérie vyberú používatelia klávesnice. Príkladom je pridanie ovládacieho prvku Button, ktoré má vlastnosť OnSelect nastavenú na Select(Parent).

  Poznámka

  Ovládacie prvky mimo galérie sa nezahŕňajú do poradia navigácie pomocou klávesnice v rámci galérii. Zohľadňujú sa ovládacie prvky TabIndexv galérii. Ďalšie informácie nájdete vo vlastnostiach zjednodušenia ovládania.

Pozrite si tiež:

Použitie DelayItemLoading rotujúceho indikátora načítavania na zlepšenie výkonu v Galérii

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).