Ovládací prvek Galerie v Power Apps

Ovládací prvek, který obsahuje další ovládací prvky a zobrazuje sadu dat.

Popis

Ovládací prvek Galerie může zobrazit více záznamů z datového zdroje a každý záznam může obsahovat více typů dat. Použijte například ovládací prvek Galerie k zobrazení několik kontaktů, kde každá položka bude zobrazovat kontaktní informace se jménem, adresou a telefonním číslem jednotlivých kontaktů.

Každé datové pole se objeví v samostatném ovládacím prvku v rámci ovládacího prvku Galerie. A tyto ovládací prvky můžete nakonfigurovat v její šabloně. Šablona se zobrazí jako první položka v galerii:

• Na levém okraji ovládacího prvku Galerie v orientaci na výšku / na šířku.
• A v horní části ovládacího prvku Galerie v orientaci na výšku / na šířku.

Všechny změny provedené v šabloně se projeví uvnitř ovládacího prvku Galerie.

K dispozici jsou předdefinované šablony pro zobrazování obrázků a textu v galerii a také galerie pro položky s proměnlivou výškou.

Omezení

Ovládací prvek Galerie má tato omezení:

1. Pokud uživatel posune ovládací prvek galerie Flexibilní výška před načtením všech položek, mohou být položky, které jsou aktuálně zobrazeny vytlačeny dolů a mimo zobrazení po dokončení načítání dat. Chcete-li se tomuto problému vyhnout, použijte standardní ovládací prvek Galerie místo varianty Flexibilní výška.
2. Následující ovládací prvky nejsou v galerii podporovány:
   • Zobrazit formulář
   • Upravit formulář
   • Prohlížeč PDF
   • Dlaždice Power BI
   • Editor formátovaného textu
   • Scrollable screen (Fluid grid)
   • Webový skener čárových kódů
3. Do jiné galerie můžete přidat pouze jednu galerii.
4. Minimální TemplateSize je jedna. To může způsobit, že se ovládací prvky v galerii odchýlí od očekávaných hodnot X nebo Y, když nezohledníte velikost šablony.
5. Pokud automaticky vygenerujete aplikaci z dat, uložíte ji a pak ji znovu otevřete, v galerii pro procházení se data nemusí zobrazit hned. Problém vyřešíte tak, že zadáte aspoň jeden znak do vyhledávacího pole a pak zadaný text odstraníte. Galerie potom zobrazí data podle očekávání.
6. Pokud galerie obsahuje ovládací prvek ComboBox, DatePicker, Slider nebo Toggle s pravidlem OnChange , které opravuje stejné zdroj dat nebo kolekci jako galerie, může to vést k neočekávanému nebo sníženému výkonu. Je to proto, že pravidlo OnChange , které opravuje zdroj dat galerie, může vytvořit nekonečný cyklus oprav a opětovného načítání. Chcete-li se tomuto problému vyhnout, je vhodné nepoužívat pravidla OnChange , když jsou tyto ovládací prvky umístěny v galerii.

Hlavní vlastnosti

Default – položka nebo záznam ze zdroje dat, které se mají vybrat při spuštění aplikace.

Items – zdroj dat zobrazený v ovládacích prvcích jako Galerie, List nebo Chart.

Selected – vybraná položka.

Další vlastnosti

AccessibleLabel – Popisek galerie (nikoli položek, které obsahuje) pro čtečky obrazovky. Měl by popisovat, jaké jsou seznamy položek.

AllItems – Položky, které jsou načteny v galerii. To může být menší než skutečný počet položek Items ve zdroj dat. Při posouvání galerie dolů lze načíst více položek. AllItems také obsahuje ovládací prvky, které se používají v každé položce galerie.

AllItemsCount – Počet položek, které jsou načteny v galerii. To může být menší než skutečný počet položek Items ve zdroj dat. Při posouvání galerie dolů lze načíst více položek.

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.

DelayItemLoading – Zpoždění při načítání položek (řádků) až po prvním načtení obrazovky.

DisplayMode – ovládací prvek umožňuje zadávání uživatelem (Edit, Úpravy), pouze zobrazuje data (View, Prohlížení) nebo je zakázaný (Disabled, Zakázáno).

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

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

ItemAccessibleLabel – Popisek každé položky galerie pro čtečky obrazovky. Měl by popisovat jednotlivé položky.

LoadingSpinner (None, Controls nebo Data) - když je nastavená hodnota None, číselník se neukáže. U ovládacích prvků | Data se zobrazí číselník, když dojde k předání vykreslení, jehož výsledkem jsou prázdné řádky.

LoadingSpinnerColor - Barva výplně číselníku načítání. Výchozí nastavení je BorderColor.

NavigationStep – vzdálenost posunutí galerie, když je vlastnost ShowNavigation nastavená na hodnotu true a uživatel vybere na jednom konci galerie navigační šipku.

Selectable – Zda lze vybrat položky galerie. Při nastavení na true identifikují čtečky obrazovky galerii jako seznam, z něhož lze vybírat. A položku vyberete výběrem hodnoty. V případ nastaven false určují čtečky obrazovky galerii jako běžný seznam a výběr položky ji nevybírá.

ShowNavigation – možnost zobrazení šipky na každém konci galerie, aby uživatel mohl procházet mezi položkami v galerii výběrem šipky.

ShowScrollbar – možnost zobrazení posuvníku při najetí myší na galerii

TemplateFill – barva pozadí galerie

TemplatePadding – vzdálenost mezi položkami v galerii

TemplateSize – Výška šablony pro galerii v orientaci na výšku/na šířku. Nebo šířka šablony pro galerii v orientaci na výšku/na šířku. Minimální velikost je jedna.

Transition – vizuální efekt (Pop (Vytlačení), Push (Zatlačení) nebo None (Žádný)), když uživatel najede myší na položku v galerii.

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

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

WrapCount – Počet zobrazených položek v řádku nebo sloupci podle orientace na šířku nebo na výšku.

X - Vzdálenost mezi levým okrajem ovládacího prvku a levým okrajem nadřazeného kontejneru nebo obrazovky.

Y - Vzdálenost mezi horním okrajem ovládacího prvku a horním okrajem nadřazeného kontejneru nebo obrazovky.

Související funkce

Filter( DataSource, Formula )

Reset( Control ) - Obnoví počáteční stav galerie. Počáteční stav zahrnuje posouvání k první položce a výběr první položky nebo výchozí, pokud existuje.

Příklady

Zobrazení a filtrování dat

• Zobrazení textu
• Zobrazit obrázky
• Filtrování dat výběrem možnosti v seznamu
• Filtrování dat úpravou posuvníku

Získání dat od uživatele

• Získání textu
• Získání obrázků
• Získání fotografií
• Získání zvuků
• Získání kreseb

Pokyny pro přístupnost

Barevný kontrast

Pokud se má položka galerie vybrat kliknutím kamkoli na položku, zajistěte adekvátní barevný kontrast mezi:

• BorderColor a barva mimo galerii (pokud existuje ohraničení).
• Fill a barva mimo galerii (pokud existuje ohraničení).

Podpora pro čtení z obrazovky

• Musí existovat vlastnost AccessibleLabel.

  Poznámka

  Čtečky obrazovky oznámí, když se položky v galerii změní. Je zmíněna také vlastnost AccessibleLabel. Poskytne se tím kontext pro oznámení a ještě důležitější to je, když je na stejné obrazovce více galerií.

• Pokud položka galerie obsahuje více ovládacích prvků, použijte ItemAccessibleLabel k zobrazení obsahu položek galerie.

• Nastavte hodnotu Selectable na true, pokud chcete, aby uživatelé vybrali položku galerie. Jinak nastavte tuto hodnotu na false.

• Pokud položka galerie obsahuje více ovládacích prvků, použijte ItemAccessibleLabel k poskytnutí souhrnu obsahů položky galerie.

• Hodnota Selectable by měla být nastavena přiměřeně v závislosti na tom, zda mají uživatelé vybrat položku galerie.

Podpora klávesnice

• Zvažte nastavení ShowScrollbar na true. Na většině zařízení s dotykovou obrazovkou se posuvník nezobrazí, dokud nezačne posouvání.

• Pokud se má položka galerie vybrat kliknutím kamkoli na položku, musí existovat také způsob, jak položku galerie vyberou uživatelé klávesnice. Příkladem je přidání ovládacího prvku Tlačítko, jehož vlastnost OnSelect je nastavená na Select(Parent).

  Poznámka

  Ovládací prvky mimo galerii se do pořadí navigace pomocí klávesnice v rámci galerii nezahrnují. Vymezené jsou vlastnosti ovládacích prvků TabIndex uvnitř galerie. Další informace najdete ve Vlastnostech usnadnění.

Viz také

Ke zlepšení výkonu v Galerii použijte DelayItemLoading a Loading spinner