Ovládací prvok galérie v aplikáciách plátnaGallery control in canvas apps

Ovládací prvok, ktorý obsahuje ďalšie ovládacie prvky a zobrazuje množinu údajov.A control that contains other controls and shows a set of data.

PopisDescription

Ovládací prvok Galéria môže zo zdroja údajov zobraziť niekoľko záznamov a každý záznam môže obsahovať niekoľko typov údajov.A Gallery control can show multiple records from a data source, and each record can contain multiple types of data. Ovládací prvok Galéria môže napríklad zobraziť niekoľko kontaktov a každá položka bude zobrazovať kontaktné informácie s menom, adresou a telefónnym číslom jednotlivých kontaktov.For example, a Gallery control can show multiple contacts with each item showing contact information that includes a name, an address, and a phone number for each contact. Každé údajové pole sa zobrazuje v samostatnom ovládacom prvku vnútri ovládacieho prvku Galéria a tieto prvky môžete nakonfigurovať v šablóne galérie.Each data field appears in a separate control within the Gallery control, and you can configure those controls in its template. Šablóna sa v galérii zobrazuje ako prvá položka na ľavom okraji ovládacieho prvku Galéria pri orientácii na šírku a v hornej časti ovládacieho prvku Galéria pri orientácii na výšku.The template appears as the first item inside the gallery, on the left edge of a Gallery control in horizontal/landscape orientation and at the top of a Gallery control in vertical/portrait orientation. Všetky zmeny vykonané v šablóne sa prejavia vnútri ovládacieho prvku Galéria.Any changes that you make in the template are reflected throughout the Gallery control.

Preddefinovaných šablón pre zobrazenie obrázkov a textu v galérii sú k dispozícii, ako aj galérie premenlivou výškou položiek.Predefined templates for showing images and text in a gallery are available, as well as a gallery for variable-height items.

ObmedzeniaLimitations

Ak sa používateľ posúva s premenlivou výškou ovládací prvok galérie, kým sa načítajú všetky položky, položka to je momentálne v zobrazení môže byť tlačené nadol a von zobrazenia po dokončení načítavania údajov.If a user scrolls the Flexible height gallery control before all items are loaded, the item that's currently in view may be pushed down and out of view when the data loading is finished. Chcete tomuto problému vyhnúť, použite štandardný galérie namiesto ovládacieho s premenlivou výškou variant.To avoid this issue, use a standard Gallery control instead of the Flexible height variant.

Základné vlastnostiKey properties

Default – položka alebo záznam zo zdroja údajov, ktoré sa majú vybrať pri spustení aplikácie.Default – The item or record from the data source to be selected in the gallery when the app starts up.

Items – zdroj údajov zobrazený v ovládacích prvkoch, ako sú Galéria, Zoznam alebo Graf.Items – The source of data that appears in a control such as a gallery, a list, or a chart.

Selected – vybratá položka.Selected – The selected item.

Ďalšie vlastnostiAdditional properties

AccessibleLabel – galérie (nie na položky obsahuje) označenie pre čítačky obrazovky.AccessibleLabel – Label of the gallery (not the items it contains) for screen readers. Malo by popisovať zoznam položiek.Should describe what the list of items are.

AllItems – všetky položky v galérii vrátane ďalších hodnôt ovládacích prvkov zahrnutých do šablóny Galérie.AllItems – All items in a gallery, including additional control values that are a part of the gallery's template.

BorderColor – farba ohraničenia ovládacieho prvku.BorderColor – The color of a control's border.

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

BorderThickness – hrúbka orámovania ovládacieho prvku.BorderThickness – The thickness of a control's border.

DisplayMode – údaj o tom, či ovládací prvok umožňuje vstup používateľa (Edit), iba zobrazuje údaje (View) alebo je zakázaný (Disabled).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

Fill – farba pozadia ovládacieho prvku.Fill – The background color of a control.

Height – vzdialenosť medzi horným a dolným okrajom ovládacieho prvku.Height – The distance between a control's top and bottom edges.

ItemAccessibleLabel – označenie jednotlivých položiek galérie pre čítačky obrazovky.ItemAccessibleLabel – Label of each gallery item for screen readers. Malo by popisovať, čo je jednotlivé položky.Should describe what each item is.

NavigationStep – vzdialenosť posunutia galérie, keď je vlastnosť ShowNavigation nastavená na hodnotu true a používateľ vyberie na jednom konci galérie navigačnú šípku.NavigationStep – How far a gallery scrolls if its ShowNavigation property is set to true and the user selects a navigation arrow at either end of that gallery.

Voliteľný – určuje, či možno vybrať položky galérie.Selectable – Whether gallery items can be selected. Ak je nastavená možnosť true, čítačky obrazovky identifikovať galérie ako voliteľný zoznam a vyberiete položku kliknutím alebo ťuknutím.When set to true, screen readers identify the gallery as a selectable list, and you select an item by clicking or tapping it. Ak je nastavená možnosť false, čítačky obrazovky identifikovať galérie ako pravidelné zoznam a kliknutím alebo ťuknutím na položku nevyberie ju.When set to false, screen readers identify the gallery as a regular list, and clicking or tapping an item doesn't select it.

ShowNavigation – možnosť zobrazenia šípky na každom konci galérie, aby používateľ mohol prechádzať medzi položkami v galérii kliknutím alebo ťuknutím na šípku.ShowNavigation – Whether an arrow appears at each end of a gallery so that a user can scroll through the items in the gallery by clicking or tapping an arrow.

ShowScrollbar – možnosť zobrazenia posúvača pri ukázaní myšou na galériu.ShowScrollbar – Whether a scrollbar appears when the user hovers over a gallery.

Snap – možnosť prechádzania galérie, pri ktorej sa automaticky preskočí na ďalšiu celú položku.Snap – Whether, when a user scrolls through a gallery, it automatically snaps so that the next item appears in full.

TemplateFill – farba pozadia galérie.TemplateFill – The background color of a gallery.

TemplatePadding – vzdialenosť medzi položkami v galérii.TemplatePadding – The distance between items in a gallery.

TemplateSize – výška šablóny pre galériu pri orientácii na výšku a šírka šablóny pre galériu pri orientácii na šírku.TemplateSize – The height of the template for a gallery in vertical/portrait orientation or the width of the template for a gallery in horizontal/landscape orientation.

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.Transition – The visual effect (Pop, Push, or None) when the user hovers over an item in a gallery.

Visible – možnosť zobrazenia alebo skrytia ovládacieho prvku.Visible – Whether a control appears or is hidden.

Width – vzdialenosť medzi ľavým a pravým okrajom ovládacieho prvku.Width – The distance between a control's left and right edges.

WrapCount – počet zobrazených položiek v riadku alebo stĺpci podľa orientácie na šírku alebo na výšku.WrapCount – Number of items shown per row or column based on horizontal or vertical layout.

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).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y – vzdialenosť medzi horným okrajom ovládacieho prvku a horným okrajom jeho nadradeného kontajnera (alebo obrazovky, ak sa nadriadený kontajner nepoužíva).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

Filter( ZdrojÚdajov; Vzorec )Filter( DataSource; Formula )

PríkladyExamples

Zobrazenie a filtrovanie údajovShow and filter data

Získanie údajov od používateľaGet data from the user

Pokyny na zjednodušenie ovládaniaAccessibility guidelines

Farebný kontrastColor contrast

Ak sa má položka galérie vybrať kliknutím kamkoľvek na položku, zaistite dostatočný farebný kontrast medzi:If clicking anywhere in a gallery item is meant to select it, there must be adequate color contrast between:

  • BorderColor a farbou mimo galérie (ak existuje orámovanie)BorderColor and the color outside the gallery (if there is a border)
  • Fill a farbou mimo galérie (ak neexistuje orámovanie)Fill and the color outside the gallery (if there is no border)

Podpora čítačiek obrazovkyScreen reader support

  • Musí byť k dispozícii vlastnosť AccessibleLabel.AccessibleLabel must be present.

    Poznámka

    Pri zmene položky v galérii prečítajú čítačky obrazovky.Screen readers will announce when items in the gallery change. Uvedú aj vlastnosť AccessibleLabel.The AccessibleLabel is also mentioned. 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í.This gives context to the announcement and is even more important when there are multiple galleries on the same screen.

  • Pri vytvorení položky galérie obsahuje niekoľko ovládacích prvkov, použite ItemAccessibleLabel na Zhrnutie položku galérie obsahu.When a gallery item contains multiple controls, use ItemAccessibleLabel to summarize the gallery item's contents.

  • Nastavte hodnotu voliteľné na true Ak chcete používateľom umožniť vybrať položku galérie.Set the value of Selectable to true if you want users to select a gallery item. V opačnom prípade nastavte túto hodnotu false.Otherwise, set that value to false.

  • Pri vytvorení položky galérie obsahuje niekoľko ovládacích prvkov, použite ItemAccessibleLabel na poskytnutie súhrnu galérie obsahu položky.When a gallery item contains multiple controls, use ItemAccessibleLabel to provide a summary of the gallery item's contents.

  • Voliteľný by mala byť nastavená správne, v závislosti od toho, či sú určené používateľom vybrať položku galérie.Selectable should be set appropriately, depending on whether users are meant to select a gallery item.

Podpora klávesniceKeyboard support

  • Zvážte nastavenie vlastnosti ShowScrollbar na hodnotu true.Consider setting ShowScrollbar to true. Na väčšine zariadení s dotykovou obrazovkou sa posúvač nezobrazí, kým používateľ nezačne posúvať obsah.On most touch screen devices, the scrollbar will not show until scrolling begins.

  • 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.If clicking anywhere in a gallery item is meant to select it, there must also be way for keyboard users to select the gallery item. Príkladom je pridanie ovládacieho prvku Tlačidlo, ktoré má vlastnosť OnSelect nastavenú na Select(Parent).For example, adding a Button that has its OnSelect property set to 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.Controls outside the gallery are not considered in the keyboard navigation order within the gallery. Pri navigácii sa zohľadňuje vlastnosť TabIndex jednotlivých ovládacích prvkov.TabIndex of controls inside a gallery are scoped. Ďalšie informácie nájdete vo vlastnostiach zjednodušenia ovládania.See accessibility properties to learn more.