Power Apps'teki birleşik giriş kutusu denetimi

Kullanıcıların sağlanan seçenekler arasından seçim yapmasına olanak sağlayan bir denetimdir. Aramayı ve birden fazla seçimi destekler.

Açıklama

Birleşik giriş kutusu denetimi, seçeceğiniz öğeler için arama yapmanıza olanak sağlar. Arama, SearchField özelliğinde sunucu tarafında gerçekleştirilir; böylece performans çok büyük veri kaynaklarından etkilenmez.

Tek veya çoklu seçim modu, SelectMultiple özelliği aracılığıyla yapılandırılır.

Öğ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.

Küçük ekranlarda görüntülerken, öğeler listesi açılır öğesi daha iyi kullanılabilirlik için tam ekran denetimi olur.

Not

Öğeleri numarayla aramak isterseniz, sayıları Text() işleviyle metne dönüştürün. Örneğin Text(12345).

Sınırlamalar

Açılan kutu denetiminde aşağıdaki sınırlamalar bulunmaktadır:

  • Bir galeride Açılan kutu denetimi kullandığınızda kullanıcı galeriyi kaydırdığında seçimleri korunmaz. Kaydırılmayan bir galeride Açılan kutu denetimini kullanıyorsanız bu bir sorun teşkil etmez. Şu anda geçici bir çözüm yoktur.

Kişi seçici

Birleşik giriş kutusu'ı 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.

Temel özellikler

Items – Seçimlerin yapılabileceği veri kaynağı.

DefaultSelectedItems – Kullanıcı denetimle etkileşime girmeden önce başlangıçta seçili olan öğeler.

Not

Default özelliği kullanım dışı, bunun yerine DefaultSelectedItems kullanın.

SelectedItems – Kullanıcı etkileşimi sonucunda elde edilen seçili öğe listesi.

SelectMultiple – Kullanıcının tek öğe veya birden çok öğe seçebildiği bilgisi.

IsSearchable – Kullanıcının seçmeden önce öğeler için arama yapıp yapamayacağı bilgisi.

Not

IsSearchable en az bir metin alanı içeren bir veri kaynağı etkinleştirilmiş olabilir. Aramayla ilgili olarak temsilci seçilebilecek sorgular için Items ifadesinin delegable olması gerekir. Bu, If ifadesinin içindeki Items ifadeleri desteklenmiyor demektir.

SearchFields – Kullanıcı metin girerken aranan veri kaynağına ait veri alanları.

Not

Birden çok alanda arama yapmak için SearchFields özelliğini şu biçimde ayarlayın: ["MyFirstColumn", "MySecondColumn"]. Yalnızca metin alanları desteklenir.

Ek özellikler

AccessibleLabel – Ekran okuyucuları için etiket.

BorderColor – Denetim kenarlığının rengi.

BorderStyleDüz, Kesik Çizgili, Noktalı veya Hiçbiri değerleriyle Denetimin kenarlık stili.

BorderThickness – Denetimin kenarlık kalınlığı.

DisplayFields – Arama sonucunda döndürülen her öğe için gösterilen alanlar listesi. Özellikler seçeneği sekmesinde Veriler bölmesi aracılığıyla yapılandırmak en kolay yöntemdir.

Not

Belirli bir şablonda birden çok görüntüleme alanını güncelleştirmek için DisplayFields özelliğini şu biçimde ayarlayın: ["MyFirstColumn", "MySecondColumn"].

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

FocusedBorderColor – Denetime odaklanıldığında denetim kenarlığının rengi.

FocusedBorderThickness – Denetime odaklanıldığında denetim kenarlığının kalınlığı.

Height – Denetimin üst ve alt kenarları arasındaki uzaklık.

InputTextPlaceholder – Hiçbir öğe seçili değilken son kullanıcılara gösterilen eğitici metin.

OnChange: Kullanıcı bir seçimi değiştirdiğinde gerçekleştirilecek eylemler.

OnNavigate: Kullanıcı bir öğe seçtiğinde gerçekleştirilecek eylemler.

OnSelect: Kullanıcı bir denetime dokunduğunda veya denetimi seçtiğinde gerçekleştirilecek eylemler.

TabIndex – Diğer denetimlerle ilişkili olarak klavye ile gezinme sırası.

Visible – Denetimin gizli veya görünür olması.

Width – Denetimin sol ve sağ kenarları arasındaki uzaklık.

X – Denetimin sol kenarı ile ana kapsayıcısının (veya ana kapsayıcı yoksa ekranın) sol kenarı arasındaki uzaklık.

Y – Denetimin üst kenarı ile ana kapsayıcısının (veya ana kapsayıcı yoksa ekranın) üst kenarı arasındaki uzaklık.

Not

Açılır öğe kenarlık özellikleri Kenarlık özellikleriyle denetlenir.

Örnekler

Temel Açılan kutu

Bu örnekteki adımlar , tablolar sunan tüm veri kaynakları için geçerlidir ancak bu adımları tam olarak uygulayabilmek için örnek veriler içeren Microsoft Dataverse veritabanına sahip bir ortam kullanın.

  1. Ekle > Input > Birleşik giriş kutusu'ı seçin ve "Combobox1" olarak adlandırın.

  2. Ekranın sağ tarafındaki Özellikler bölmesinde, Bir veri kaynağı seçin listesini (Items'in yanında) açın ve Firmalar tablosu gibi bir veri kaynağı ekleyin veya seçin.

  3. Aynı bölmede Düzenle'yi (Alanlar'ın yanında) seçin.

  4. Data bölmesinde, Birincil metin listesini açın ve ardından Birleşik giriş kutusu denetiminde görüntülenecek Birincil Ad sütununu seçin.

  5. Alt tuşunu basılı tutarken aşağı okunu seçerek Birleşik giriş kutusu denetimini açın.

    Denetim, belirttiğiniz veri kaynağında belirttiğiniz Birincil Ad verilerini gösterir.

(İsteğe Bağlı) Varsayılan olarak ilk kaydı gösterme

  1. DefaultSelectedItems özelliğini bu ifadeye göre ayarlayın ve DataSource öğesini veri kaynağınızın adıyla değiştirin:

    First(DataSource)
    

(İsteğe Bağlı) Seçili Firma Adı değerini bir etikette görüntüleme

  1. Ekle > Metin etiketi'ni seçin ve ardından Label'i seçin.

  2. Text özelliğini bu ifadeye göre ayarlayın ve Metin öğesini şu formülle değiştirin:

    If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")
    

    Not

    If ifadesi, kaç seçili öğe olduğunu kontrol eder ve bunları virgülle ayrılmış bir etikette gösterir veya boşsa "SEÇİLİ ÖĞE YOK" iletisini gösterir.

Basit açılan davranış simülasyonu yapma

IsSearchable öğesini yanlış olarak ve SelectMultiple öğesini yanlış olarak ayarlayıp açılan menü işlevselliğini elde edebilirsiniz.

  1. Ekle > Input'i seçin ve ardından Birleşik giriş kutusu'ı seçin.

  2. Ekranın sağ tarafındaki Özellikler bölmesinde, Bir veri kaynağı seçin listesini (Items'in yanında) açın ve bir veri kaynağı ekleyin veya seçin.

  3. Aynı bölmede Düzenle'yi (Alanlar'ın yanında) seçin.

  4. Data bölmesinde Birincil metin listesini açın ve ardından Birleşik giriş kutusu denetiminde göstermek istediğiniz sütunu seçin.

  5. IsSearchable özelliğini false olarak ayarlayın.

  6. SelectMultiple özelliğini false olarak ayarlayın.

  7. Alt tuşunu basılı tutarken aşağı okunu seçerek Birleşik giriş kutusu denetimini açın.

    Denetim, belirttiğiniz veri kaynağındaki belirttiğiniz sütundan verileri gösterir.

    Not

    "Öğeleri bul" metni kaybolur ve yalnızca tek bir öğe seçebilirsiniz.

Erişilebilirlik yönergeleri

Renk karşıtlığı

Şunlar arasında yeterli bir renk karşıtlığı olmalıdır:

  • ChevronFill ve ChevronBackground
  • ChevronHoverFill ve ChevronHoverBackground
  • SelectionColor ve SelectionFill
  • SelectionFill ve Fill
  • SelectionTagColor ve SelectionTagFill

Bu, standart renk karşıtlığı gereksinimlerine ek niteliğindedir.

Ekran okuyucusu desteği

  • AccessibleLabel mevcut olmalıdır.

    Not

    Dokunmatik ekranlarda ekran okuyucu kullanıcıları, birleşik giriş kutusunun içeriğine sırayla gidebilir. Birleşik giriş kutusu, seçildiğinde içeriğini gösteren veya gizleyen bir düğme olarak hareket eder.

Klavye desteği

  • Klavye kullanıcılarının gidebilmesi için TabIndex sıfır veya daha büyük olmalıdır.

  • Odak göstergeleri açıkça görünür olmalıdır. Bunu sağlamak için FocusedBorderColor ve FocusedBorderThickness özelliklerini kullanın.

    Not

    Sekme tuşu birleşik giriş kutusuna gider veya açılır kutudan çıkar. Ok tuşları birleşik giriş kutusunun içeriğine gider. Escape tuşu, açık olan açılır listeyi kapatır.

Not

Belge dili tercihlerinizi bizimle paylaşabilir misiniz? Kısa bir ankete katılın. (lütfen bu anketin İngilizce olduğunu unutmayın)

Anket yaklaşık yedi dakika sürecektir. Kişisel veri toplanmaz (gizlilik bildirimi).