PowerApps'teki Açılır kutu denetimiCombo box control in PowerApps

Kullanıcıların sağlanan seçenekler arasından seçim yapmasına olanak sağlayan bir denetimdir.A control that allows users to make selections from provided choices. Aramayı ve birden fazla seçimi destekler.Supports search and multiple selections.

AçıklamaDescription

Açılır kutu denetimi, seçeceğiniz öğeler için arama yapmanıza olanak sağlar.A Combo box control allows you to search for items you will select. Arama, SearchField özelliğinde sunucu tarafında gerçekleştirilir; böylece performans çok büyük veri kaynaklarından etkilenmez.The search is performed server-side on the SearchField property so performance is not affected by very large data sources.

Tek veya çoklu seçim modu, SelectMultiple özelliği aracılığıyla yapılandırılır.Single or multi-select mode is configured via the SelectMultiple property.

Öğeleri seçmek için arama yaparken, Veriler bölmesindeki Düzen ayarlarını değiştirerek her öğe için bir tek veri değeri, iki değer veya bir resim ve iki değer (Kişi) göstermeyi seçebilirsiniz.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.

Kişi seçiciPeople picker

Açılır kutu'yu kişi seçici olarak kullanmak için Veri bölmesindeki Düzen ayarlarından Kişi şablonunu seçin ve aşağıda verilen, kişi için gösterilecek ilgili veri özelliklerini yapılandırın.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.

Temel özelliklerKey properties

Items: seçimlerin yapılabileceği veri kaynağı.Items – The source of data from which selections can be made.

DefaultSelectedItems – seçili olan öğeler önce kullanıcı denetimle etkileşim kurar.DefaultSelectedItems – The initial selected item(s) before the user interacts with the control.

SelectedItems: kullanıcı etkileşimi sonucunda elde edilen seçili öğe listesi.SelectedItems – List of selected items resulting from user interaction.

SelectMultiple: kullanıcının tek öğe veya birden çok öğe seçip seçemediği.SelectMultiple – Whether the user can select a single item or multiple items.

IsSearchable: kullanıcının seçmeden önce öğeler için arama yapıp yapamadığı.IsSearchable – Whether the user can search for items before selecting.

SearchFields: Kullanıcı metin girerken aranan veri kaynağına ait v eri alanları.SearchFields - The data fields of the data source searched when user is entering text. Birden çok alanda aramak için şu ayarı belirleyin: ComboBox1.SearchFields = ["MyFirstColumn", "MySecondColumn"]To search on multiple fields, set ComboBox1.SearchFields = ["MyFirstColumn", "MySecondColumn"]

Ek özelliklerAdditional properties

AccessibleLabel – Ekran okuyucular için etiket.AccessibleLabel – Label for screen readers.

BorderColor: bir denetimin kenarlığının rengi.BorderColor – The color of a control's border.

BorderStyle: Düz, Kesik Çizgili, Noktalı veya Hiçbiri değerleriyle bir denetimin kenarlık stili.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness: bir denetimin kenarlık kalınlığı.BorderThickness – The thickness of a control's border.

DisplayFields: arama sonucunda döndürülen her öğe için gösterilen alan listesi.DisplayFields – List of fields shown for each item returned by the search. Özellikler seçeneği sekmesinde Veriler bölmesi aracılığıyla yapılandırmak en kolay yöntemdir.Easiest to configure via the Data pane in the Properties option tab.

DisplayMode: denetimin kullanıcı girişine izin verip vermediği (Edit), yalnızca veri görüntüleyip görüntülemediği (View) veya devre dışı olup olmadığı (Disabled).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

FocusedBorderColor – Denetim odaklandığında denetim kenarlığının rengi.FocusedBorderColor – The color of a control's border when the control is focused.

FocusedBorderThickness – Denetim odaklandığında denetim kenarlığının kalınlığı.FocusedBorderThickness – The thickness of a control's border when the control is focused.

Height: denetimin üst ve alt kenarları arasındaki uzaklık.Height – The distance between a control's top and bottom edges.

InputTextPlaceholder: hiçbir öğe seçili değilken son kullanıcılara gösterilen eğitici metin.InputTextPlaceholder – Instructional text shown to end-users when no items are selected.

OnChange: kullanıcının bir seçimi değiştirmesinin ardından uygulamanın nasıl yanıt verdiği.OnChange – How the app responds when the user changes a selection.

OnNavigate: kullanıcının bir öğeye tıklamasının ardından uygulamanın nasıl yanıt verdiği.OnNavigate – How the app responds when the user clicks on an item.

OnSelect: kullanıcının bir denetime dokunmasının veya tıklamasının ardından uygulamanın nasıl yanıt verdiği.OnSelect – How the app responds when the user taps or clicks a control.

TabIndex – Diğer denetimlerle ilgili olarak klavye ile gezinme sırası.TabIndex – Keyboard navigation order in relation to other controls.

Visible: denetimin gizli veya görünür olması.Visible – Whether a control appears or is hidden.

Width: denetimin sol ve sağ kenarları arasındaki uzaklık.Width – The distance between a control's left and right edges.

X: denetimin sol kenarı ile üst kapsayıcısının (üst kapsayıcı mevcut değilse ekranın) sol kenarı arasındaki uzaklık.X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y: denetimin üst kenarı ile üst kapsayıcının (üst kapsayıcı mevcut değilse ekranın) üst kenarı arasındaki uzaklık.Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

ÖrnekExample

  1. Üzerinde Ekle sekmesini denetimleri menüsüne ve ardından birleşik giriş kutusu.On the Insert tab, open the Controls menu, and then select Combo box.

  2. Üzerinde özellikleri sekmesine sağ bölmede, açık bir veri kaynağı seçin listesi (yanındaki öğeleri) ve ardından eklemek veya bir veri kaynağı seçin.On the Properties tab of the right-hand pane, open the Select a data source list (next to Items), and then add or select a data source.

  3. Aynı sekmede seçin Düzenle (yanındaki alanları).On the same tab, select Edit (next to Fields).

  4. İçinde veri bölmesi açık birincil metin listeleyin ve ardından göstermek istediğiniz sütunu seçin birleşik giriş kutusu denetimi.In the Data pane, open the Primary text list, and then select the column that you want to show in the Combo box control.

  5. Alt tuşunu basılı tutarak açmak için aşağı oku seçin birleşik giriş kutusu denetimi.While holding down the Alt key, select the down arrow to open the Combo box control.

    Denetim, belirttiğiniz veri kaynağında belirtilen sütun verileri gösterir.The control shows the data from the column that you specified in the data source that you specified.

  6. (isteğe bağlı) Varsayılan olarak ilk kaydı göstermek için DefaultSelectedItems özelliğini şu ifade değiştirerek DataSource veri kaynağınızın adıyla:(optional) To show the first record by default, set the DefaultSelectedItems property to this expression, replacing DataSource with the name of your data source:

    First(DataSource)

Erişilebilirlik yönergeleriAccessibility guidelines

Renk karşıtlığıColor contrast

Şunlar arasında yeterli bir renk karşıtlığı olmalıdır:There must be adequate color contrast between:

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

Bu, standart renk karşıtlığı gereksinimlerine ek niteliğindedir.This is in addition to the standard color contrast requirements.

Ekran okuyucu desteğiScreen reader support

  • AccessibleLabel mevcut olmalıdır.AccessibleLabel must be present.

    Not

    Dokunmatik ekranlarda ekran okuyucusu kullanıcıları, açılır kutunun içeriğine sırayla gidebilir.On touch screens, screen reader users can navigate the contents of the combo box sequentially. Açılır kutu, seçildiğinde içeriklerini gösteren veya gizleyen bir düğme olarak hareket eder.The combo box acts as a button that shows or hides its contents when selected.

Klavye desteğiKeyboard support

  • Klavye kullanıcılarının gidebilmesi için TabIndex sıfır veya daha büyük olmalıdır.TabIndex must be zero or greater so that keyboard users can navigate to it.

  • Odak göstergeleri açıkça görünür olmalıdır.Focus indicators must be clearly visible. Bunu sağlamak için FocusedBorderColor ve FocusedBorderThickness kullanın.Use FocusedBorderColor and FocusedBorderThickness to achieve this.

    Not

    Sekme tuşu açılır kutuya gider veya açılır kutudan çıkar.The tab key navigates to or away from the combo box. Ok tuşları açılır kutunun içeriğine gider.Arrow keys navigate the contents of the combo box. Escape tuşu açık olan açılır listeyi kapatır.The escape key closes the drop down when opened.