Controlul casetei combinate în Power Apps

Un control care permite utilizatorilor să facă selecții din alegerile furnizate. Acceptă căutarea și mai multe selecții.

Descriere

Un control Cutie combinată vă permite să căutați articole pe care le veți selecta. Căutarea se efectuează pe partea serverului pe proprietatea SearchField, astfel încât performanța nu este afectată de surse de date mari.

Modul unic sau multi-selectare este configurat prin proprietatea SelectareMultiplă.

Când căutați elemente pentru a le selecta, pentru fiecare element puteți alege să afișați o singură valoare de date, două valori sau o imagine și două valori (persoană) prin modificarea setărilor de aspect din panoul de date.

Când vizualizați pe ecrane mici, fișa listei de elemente va deveni un control pe ecranul complet pentru o mai bună utilizare.

Notă

Dacă doriți să căutați elemente cu numere, convertiți numerele în text cu funcția Text(). De exemplu, Text(12345).

Limitări

Controlul casetei combinate are aceste limitări:

  • Când utilizați un control casetă combinată în interiorul unei galerii, selecțiile acesteia nu sunt menținute atunci când utilizatorul derulează galeria. Aceasta nu este o problemă dacă utilizați un control casetă combinată într-o galerie care nu derulează. Momentan, nu este disponibilă o soluție.

Selector de persoane

Pentru a folosi Caseta combinată ca selector de persoane, alegeți șablonul Persoană din setările de aspect din panoul de date și configurați proprietățile de date aferente care vor fi afișate pentru persoana de mai jos.

Proprietăți cheie

Articole - Sursa de date din care se pot face selecții.

ElementeSelectateImplicit - Elementele inițiale selectate înainte ca utilizatorul să interacționeze cu controlul.

Notă

Proprietatea Default este perimată, folosiți în schimb DefaultSelectedItems.

ElementeSelectate - Lista elementelor selectate rezultate din interacțiunea cu utilizatorul.

SelectMultiple - Dacă utilizatorul poate selecta un singur articol sau mai multe articole.

SeCaută - Dacă utilizatorul poate căuta articole înainte de a selecta.

Notă

IsSearchable poate fi activată numai pe o sursă de date care conține cel puțin un câmp de text. Expresia Elemente trebuie să fie delegabilă pentru ca interogările să fie delegate cu căutarea. Asta înseamnă, declarațiile Dacă din cadrul expresiei Elemente nu sunt acceptate.

CăutareCâmpuri - Câmpurile de date ale sursei de date căutate atunci când utilizatorul introduce text.

Notă

Pentru a căuta pe mai multe câmpuri, setați proprietatea SearchFields în acest format: ["MyFirstColumn", "MySecondColumn"]. Sunt acceptate doar câmpurile de text.

Proprietăți suplimentare

AccessibleLabel – Etichetă pentru cititoare de ecran.

BorderColor - Culoarea bordurii unui control.

BorderStyle - Dacă bordura unui control este de tip Continuu, Linii, Puncte sau Fără.

BorderThickness - Grosimea bordurii unui control.

CâmpuriAfișate - Lista câmpurilor afișate pentru fiecare articol returnat de căutare. Cel mai simplu de configurat prin panoul de date din fila de opțiuni a Proprietăților.

Notă

Pentru a actualiza mai multe câmpuri de afișare într-un șablon dat, setați proprietatea DisplayFields în acest format: ["MyFirstColumn", "MySecondColumn"].

DisplayMode - Dacă controlul permite date introduse de utilizator (Editare), afișează numai datele (Vizualizare) sau este dezactivat (Dezactivat).

FocusedBorderColor – Culoarea bordurii unui control atunci când controlul este focalizat.

FocusedBorderThickness – Grosimea bordurii unui control atunci când controlul este focalizat.

Height - Distanța dintre marginile superioare și inferioare ale unui control.

InputTextPlaceholder - Text instructiv prezentat utilizatorilor finali atunci când nu este selectat niciun element.

OnChange – Acțiuni de efectuat atunci când utilizatorul modifică un control.

OnNavigate – Acțiuni de efectuat atunci când utilizatorul selectează un element.

OnSelect – Acțiuni de efectuat atunci când utilizatorul atinge sau selectează un control.

TabIndex – Comanda de navigare prin tastatură comparativ cu alte controale.

Visible - Dacă un control este vizibil sau ascuns.

Width - Distanța dintre marginea din stânga și cea din dreapta a unui control.

X- Distanța dintre marginea din stânga a unui control și marginea din stânga a containerului părinte al acestuia (a ecranului, dacă nu există un container părinte).

Y - Distanța dintre marginea de sus a unui control și marginea de sus a containerului părinte al acestuia (a ecranului, dacă nu există un container părinte).

Notă

Proprietățile chenarului flotant sunt controlate de proprietățile Chenar.

Exemple

Casetă Basic Combo

Pașii din acest exemplu se aplică oricărei sursă de date care oferă tabele, dar pentru a urma exact acești pași, utilizați un mediu cu baza de date Microsoft Dataverse cu date eșantion.

  1. Select Inserare > Intrare > Casetă combo și denumiți-o "Combobox1".

  2. Pe panoul Proprietăți din partea dreaptă a ecranului, deschideți lista Selectați o sursă de date (lângă Elemente), apoi adăugați sau selectați o sursă de date, cum ar fi tabelul Conturi.

  3. În același panou, selectați Editați (chiar lângă Câmpuri).

  4. În panoul Date, deschideți fișierul Text primar, apoi selectați coloana Nume primar care va fi afișată în controlul Casetă combo.

  5. În timp ce țineți apăsată tasta Alt selectați săgeata în jos pentru a deschide controlul Casetă combo.

    Controlul afișează datele din numele principal pe care le-ați specificat în sursă de date pe care l-ați specificat.

(Opțional) Afișați prima înregistrare în mod implicit

  1. Setați proprietatea DefaultSelectedItems la această expresie, înlocuind DataSource cu numele sursei dvs. de date:

    First(DataSource)
    

(Opțional) Afișați valoarea Nume cont selectată într-o etichetă

  1. Selectați Inserare > Etichetă text, apoi selectați Eticheta.

  2. Setați proprietatea Text la această expresie, înlocuind Text cu următoarea formulă:

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

    Notă

    Instrucțiunea If va verifica pentru a vedea cum pot exista elementele selectate și le va afișa într-o etichetă delimitată prin virgule sau într-un mesaj „FĂRĂ ARTICOL SELECTAT” când este gol.

Simulează un comportament simplu drop-down

Prin setarea IsSearchable la fals și SelectMultiple, puteți obține aceeași funcționalitate ca o listă derulantă.

  1. Selectați Inserare > Intrare, apoi selectați Casetă combo.

  2. Pe panoul Proprietăți din partea dreaptă a ecranului, deschideți lista Selectați o sursă de date (lângă Elemente), apoi adăugați sau selectați o sursă de date.

  3. În același panou, selectați Editați (chiar lângă Câmpuri).

  4. În panoul Date deschideți lista Text primar apoi selectați coloana pe care doriți să o afișați în controlul Casetă combinată.

  5. Setați proprietatea IsSearchable la fals.

  6. Setați proprietatea SelectMultiple la fals.

  7. În timp ce țineți apăsată tasta Alt selectați săgeata în jos pentru a deschide controlul Casetă combo.

    Controlul arată datele din coloana specificată în sursa de date pe care ați specificat-o.

    Notă

    Textul „Căutare articole” a dispărut și că veți putea selecta doar un singur element.

Orientări privind accesibilitatea

Contrast de culoare

Trebuie să existe un contrast adecvat de culoare între:

  • ChevronFill și ChevronBackground
  • ChevronHoverFill și ChevronHoverBackground
  • CuloareSelecție și UmplereSelecție
  • UmplereSelecție și Umplere
  • SelecțieCuloareEtichetă și SelecțieUmplereEtichetă

Acest lucru este în plus față de cerințe standard de contrast de culoare.

Asistență pentru cititor de ecran

  • AccessibleLabel trebuie să fie prezent.

    Notă

    Pe ecranele tactile, utilizatorii cititorilor de ecran pot naviga secvențial conținutul casetei combinate. Caseta combinată acționează ca un buton care arată sau ascunde conținutul său atunci când este selectat.

Suport tastatură

  • TabIndex trebuie să fie egal cu zero sau mai mare, așa încât utilizatorii tastaturii să poată naviga acolo.

  • Indicatorii de focalizare trebuie să fie clar vizibili. Utilizați FocusedBorderColor și FocusedBorderThickness pentru a realiza acest lucru.

    Notă

    Tasta filă navighează spre sau dinspre caseta combinată. Tastele săgeată navighează în conținutul casetei combinate. Tasta Esc închide meniul derulant când este deschis.

Notă

Ne puteți spune care preferințele dvs. lingvistice pentru documentație? Răspundeți la un chestionar scurt. (rețineți că acest chestionar este în limba engleză)

Chestionarul va dura aproximativ șapte minute. Nu sunt colectate date personale (angajament de respectare a confidențialității).