Ovládací prvok Rozbaľovacie pole v službe PowerAppsCombo box control in PowerApps

Ovládací prvok umožňujúci používateľom vyberať z ponúknutých možností.A control that allows users to make selections from provided choices. Podporuje vyhľadávanie a výber viacerých možností.Supports search and multiple selections.

PopisDescription

Ovládací prvok Rozbaľovacie pole vám umožňuje vyhľadávanie položiek, ktoré si zvolíte.A Combo box control allows you to search for items you will select. Vyhľadávanie prebieha na základe vlastnosti SearchField na strane serveru, takže výkon nie je ovplyvnený veľkými zdrojmi údajov.The search is performed server-side on the SearchField property so performance is not affected by very large data sources.

Režim jednoduchého alebo viacnásobného výberu je nakonfigurovaný prostredníctvom vlastnosti SelectMultiple.Single or multi-select mode is configured via the SelectMultiple property.

Pri vyhľadávaní položiek, ktoré chcete vybrať, môžete zmenou nastavenia rozloženia v Table s údajmi vybrať pre každú položku na zobrazenie jednu hodnotu údajov, dve hodnoty alebo obrázok a dve hodnoty (osoba).When searching for items to select, for each item you can choose to show a single data value, two values, or a picture and two values (Person) by modifying the Layout settings in the Data pane.

Výber osôbPeople picker

Ak chcete použiť Rozbaľovacie pole ako prostriedok na výber osôb, vyberte v nastaveniach rozloženia v Table s údajmi šablónu Osoba a nakonfigurujte vlastnosti príslušných údajov, ktoré sa majú pre danú osobu zobraziť.To use Combo box as a people picker, choose the Person template from the Layout settings in the Data pane and configure the related data properties to be shown for the person below.

Základné vlastnostiKey properties

Items – Zdroj údajov, z ktorého je možné vyberať.Items – The source of data from which selections can be made.

DefaultItems – Počiatočne vybratá položka alebo položky pred interakciou používateľa s ovládacím prvkom.DefaultItems – The initial selected item(s) before the user interacts with the control.

SelectedItems – Zoznam vybratých položiek vyplývajúcich z interakcie používateľa.SelectedItems – List of selected items resulting from user interaction.

SelectMultiple – možnosť používateľa vybrať jednu alebo viac položiek.SelectMultiple – Whether the user can select a single item or multiple items.

IsSearchable – možnosť používateľa vyhľadávať pred výberom.IsSearchable – Whether the user can search for items before selecting.

SearchFields – pri zadávaní textu používateľom sa prehľadávajú dátové polia zdroja údajov.SearchFields - The data fields of the data source searched when user is entering text. Ak chcete hľadať vo viacerých poliach, nastavte ComboBox1.SearchFields = ["Môj_prvý_stĺpec", "Môj_druhý_stĺpec"].To search on multiple fields, set ComboBox1.SearchFields = ["MyFirstColumn", "MySecondColumn"]

Ďalšie vlastnostiAdditional properties

AccessibleLabel – označenie pre čítačky obrazovky.AccessibleLabel – Label for screen readers.

BorderColor – farba orámovania 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.

Default – počiatočný výber pred zmenou, ktorú urobí používateľ v režime jednoduchého výberu.Default – The initial selection before it is changed by the user in single-select mode.

DisplayFields – zoznam polí zobrazených pre každú vyhľadanú položku.DisplayFields – List of fields shown for each item returned by the search. Najjednoduchšie sa nakonfiguruje prostredníctvom tably s údajmi v možnostiach karty Vlastnosti.Easiest to configure via the Data pane in the Properties option tab.

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

FocusedBorderColor – farba orámovania zameraného ovládacieho prvku.FocusedBorderColor – The color of a control's border when the control is focused.

FocusedBorderThickness – hrúbka orámovania zameraného ovládacieho prvku.FocusedBorderThickness – The thickness of a control's border when the control is focused.

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

InputTextPlaceholder – inštruktážny text zobrazený pre koncových používateľov, keď nie sú vybraté žiadne položky.InputTextPlaceholder – Instructional text shown to end-users when no items are selected.

OnChange – spôsob reakcie aplikácie na zmenu výberu používateľom.OnChange – How the app responds when the user changes a selection.

OnNavigate – spôsob reakcie aplikácie na kliknutie na položku používateľom.OnNavigate – How the app responds when the user clicks on an item.

OnSelect – spôsob reakcie aplikácie na ťuknutie alebo kliknutie na ovládací prvok používateľom.OnSelect – How the app responds when the user taps or clicks a control.

TabIndex – príkaz na navigáciu pomocou klávesnice vo vzťahu k iným ovládacím prvkom.TabIndex – Keyboard navigation order in relation to other controls.

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.

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 nadriadeného kontajnera (alebo obrazovky, ak sa nadradený 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).

PríkladExample

  1. Pridajte ovládací prvok Rozbaľovacie pole z ponuky Ovládacie prvky na karte Vložiť.Add a Combo box control from the Insert tab, Controls menu.

  2. Na karte možností vlastností kliknite na položku Údaje.In the Properties options tab, click on Data.

  3. Vyberte zdroj údajov, rozloženie a súvisiace vlastnosti.Select the data source, layout and related properties below.

  4. Na karte Rozšírené nastavte vlastnosť SelectMultiple.Set the SelectMultiple property in the Advanced tab.

    V aplikácii sa zobrazí funkčné Rozbaľovacie pole.A functional Combo box will appear in your app.

    Pozrite sa, ako pridať a nakonfigurovať ovládací prvok.Don't know how to add and configure a control?.

Pokyny na zjednodušenie ovládaniaAccessibility guidelines

Farebný kontrastColor contrast

Dostatočný farebný kontrast musí byť medzi:There must be adequate color contrast between:

  • ChevronFill a ChevronBackgroundChevronFill and ChevronBackground
  • ChevronHoverFill a ChevronHoverBackgroundChevronHoverFill and ChevronHoverBackground
  • SelectionColor a SelectionFillSelectionColor and SelectionFill
  • SelectionFill a FillSelectionFill and Fill
  • SelectionTagColor a SelectionTagFillSelectionTagColor and SelectionTagFill

Ide o doplnok k štandardným požiadavkám na farebný kontrast.This is in addition to the standard color contrast requirements.

Podpora čítačiek obrazovkyScreen reader support

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

    Poznámka

    Na dotykových obrazovkách môžu používatelia čítačky obrazovky prechádzať obsahom rozbaľovacieho poľa postupne.On touch screens, screen reader users can navigate the contents of the combo box sequentially. Rozbaľovacie pole funguje ako tlačidlo, ktoré svoj obsah zobrazí alebo skryje pri výbere.The combo box acts as a button that shows or hides its contents when selected.

Podpora klávesniceKeyboard support

  • Vlastnosť TabIndex musí mat hodnotu nula alebo väčšiu, aby používatelia klávesnice na ňu mohli prejsť.TabIndex must be zero or greater so that keyboard users can navigate to it.

  • Indikátory zamerania musia byť jasne viditeľné.Focus indicators must be clearly visible. Dosiahnete to použitím vlastností FocusedBorderColor a FocusedBorderThickness.Use FocusedBorderColor and FocusedBorderThickness to achieve this.

    Poznámka

    Pomocou klávesu Tab možno prejsť na rozbaľovacie pole alebo mimo neho.The tab key navigates to or away from the combo box. Pomocou klávesov so šípkami možno prechádzať obsahom rozbaľovacieho poľa.Arrow keys navigate the contents of the combo box. Pomocou klávesu Esc možno zatvoriť otvorené rozbaľovacie pole.The escape key closes the drop down when opened.