Besturingselement Keuzelijst met invoervak in Power Apps

Een besturingselement waarmee gebruikers selecties kunnen maken in geboden opties. Ondersteunt zoeken en meervoudige selectie.

Beschrijving

Met een besturingselement voor Keuzelijst met invoervak kunt u zoeken naar items die u gaat selecteren. De zoekopdracht wordt aan de serverzijde uitgevoerd op de eigenschap SearchField, zodat de prestaties niet worden beïnvloed door grote gegevensbronnen.

De modus voor enkelvoudige of meervoudige selectie wordt geconfigureerd via de eigenschap SelectMultiple.

Wanneer u zoekt naar items om te selecteren, kunt u bij elk item ervoor kiezen één gegevenswaarde, twee waarden of een afbeelding en twee waarden (Persoon) weer te geven door de instelling Indeling in het deelvenster Gegevens te wijzigen.

Bij weergave op kleine schermen wordt de flyout met de lijst met items een besturingselement op een volledig scherm voor een betere bruikbaarheid.

Personen selecteren

Als u personen wilt selecteren met behulp van een Keuzelijst met invoervak, kiest u de sjabloon Persoon bij de opmaakinstellingen in het deelvenster Gegevens en configureert u de desbetreffende gegevenseigenschappen die voor de onderstaande persoon moeten worden weergegeven.

Belangrijkste eigenschappen

Items: De gegevensbron waarin selecties kunnen worden gemaakt.

DefaultSelectedItems: Het/de aanvankelijk geselecteerde item(s) voordat de gebruiker het besturingselement gebruikt.

SelectedItems: Een lijst met geselecteerde items als gevolg van gebruikersinteractie.

SelectMultiple: Bepaalt of de gebruiker één item of meerdere items kan selecteren.

IsSearchable: Bepaalt of de gebruiker naar items kan zoeken alvorens ze te selecteren.

SearchFields: De gegevensvelden van de betreffende gegevensbron wanneer de gebruiker tekst invoert.

Aanvullende eigenschappen

AccessibleLabel: label voor schermlezers.

BorderColor: de kleur van de rand van een besturingselement.

BorderStyle: hiermee wordt aangegeven of de rand van een besturingselement effen, onderbroken of gestippeld is, of dat er geen rand is.

BorderThickness: de dikte van de rand van een besturingselement.

DisplayFields: Een lijst met velden die worden weergegeven voor elk item dat de zoekopdracht retourneert. Dit is het gemakkelijkst te configureren via het deelvenster Gegevens op het tabblad Eigenschappen.

DisplayMode: bepaalt of invoer van de gebruiker is toegestaan (Edit), of gegevens alleen worden weergegeven (View) of het besturingselement wordt uitgeschakeld (Disabled).

FocusedBorderColor: de kleur van de rand van een besturingselement wanneer de focus op het besturingselement ligt.

FocusedBorderThickness: de dikte van de rand van een besturingselement wanneer de focus op het besturingselement ligt.

Height: de afstand tussen de boven- en onderrand van een besturingselement.

InputTextPlaceholder: Instructietekst die aan eindgebruikers wordt getoond wanneer er geen items zijn geselecteerd.

OnChange: Acties die moeten worden uitgevoerd wanneer de gebruiker een selectie wijzigt.

OnNavigate: Acties die moeten worden uitgevoerd wanneer de gebruiker een item selecteert.

OnSelect: Acties die moeten worden uitgevoerd wanneer de gebruiker op een besturingselement tikt of er een selecteert.

TabIndex: de navigatievolgorde op het toetsenbord ten opzichte van andere besturingselementen.

Visible: hiermee wordt aangegeven of een besturingselement zichtbaar of verborgen is.

Width: de afstand tussen de linker- en rechterrand van een besturingselement.

X: de afstand tussen de linkerrand van een besturingselement en de linkerrand van de bovenliggende container (het scherm als er geen bovenliggende container is).

Y: de afstand tussen de bovenrand van een besturingselement en de bovenrand van de bovenliggende container (het scherm als er geen bovenliggende container is).

Voorbeelden

Eenvoudige keuzelijst met invoervak

De stappen in dit voorbeeld gelden voor elke gegevensbron die tabellen levert, maar om deze stappen exact te volgen, gebruikt u een omgeving waarin een Microsoft Dataverse-database voorbeeldgegevens bevat.

1. Selecteer Invoegen > Invoer > Keuzelijst met invoervak en geef deze de naam "Keuzelijstmetinvoervak1".

2. Op het deelvenster Eigenschappen aan de rechterkant van het scherm opent u de lijst Een gegevensbron selecteren (naast Items); daarna selecteert u een gegevensbron als de tabel Accounts of voegt u deze toe.

3. Selecteer in hetzelfde deelvenster Bewerken (naast Velden).

4. Open in het deelvenster Gegevens de lijst Primaire tekst en selecteer de kolom Primaire naam die wordt weergegeven in het besturingselement Keuzelijst met invoervak.

5. Terwijl u de Alt-toets ingedrukt houdt, selecteert u de pijl-omlaag om het besturingselement Keuzelijst met invoervak te openen.

   Het besturingselement toont de gegevens van de Primaire naam die u hebt opgegeven in de gegevensbron die u hebt opgegeven.

(Optioneel) Het eerste record standaard weergeven

1. Stel de eigenschap DefaultSelectedItems in op deze expressie, waarmee u Gegevensbron vervangt door de naam van uw gegevensbron:

   First(DataSource)
   

(Optioneel) Geselecteerde accountnaam weergeven in een label

1. Selecteer Invoegen > Tekstlabel en vervolgens Label.

2. Stel de eigenschap Text in op deze expressie, waarmee u Text vervangt door de volgende formule:

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

   Notitie

   De If-instructie controleert hoeveel geselecteerde items er zijn en geeft ze weer in een door komma's gescheiden label of in een bericht "GEEN ITEM GESELECTEERD" als deze leeg is.

Eenvoudig vervolgkeuzegedrag simuleren

Door IsSearchable op onwaar te zetten en SelectMultiple op onwaar, kunt u dezelfde functionaliteit van een vervolgkeuze bereiken.

1. Selecteer Invoegen > Invoer en vervolgens Keuzelijst met invoervak.

2. Op het deelvenster Eigenschappen aan de rechterkant van het scherm opent u de lijst Een gegevensbron selecteren (naast Items); daarna selecteert u een gegevensbron of voegt u deze toe.

3. Selecteer in hetzelfde deelvenster Bewerken (naast Velden).

4. Open in het deelvenster Gegevens de lijst Primaire tekst en selecteer de kolom die u wilt tonen in het besturingselement Keuzelijst met invoervak.

5. Stel de eigenschap IsSearchable in op onwaar.

6. Stel de eigenschap SelectMultiple in op onwaar.

7. Terwijl u de Alt-toets ingedrukt houdt, selecteert u de pijl-omlaag om het besturingselement Keuzelijst met invoervak te openen.

   Het besturingselement toont de gegevens uit de kolom die u hebt opgegeven in de gegevensbron die u hebt opgegeven.

   Notitie

   De tekst "Items zoeken" is verdwenen en u kunt alleen één item selecteren.

Richtlijnen voor toegankelijkheid

Kleurcontrast

Er moet voldoende kleurcontrast zijn tussen:

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

Dit komt bovenop de standaardvereisten voor kleurcontrast.

Ondersteuning voor schermlezer

• AccessibleLabel moet aanwezig zijn.

  Notitie

  Op aanraakschermen kunnen gebruikers van de schermlezer achtereenvolgens door de inhoud van de keuzelijst met invoervak navigeren. De keuzelijst met invoervak werkt als een knop die, indien geselecteerd, de inhoud weergeeft of verbergt.

Ondersteuning voor toetsenbord

• TabIndex moet nul of groter zijn, zodat toetsenbordgebruikers ernaartoe kunnen navigeren.

• De focusindicatoren moeten duidelijk zichtbaar zijn. Gebruik hiervoor FocusedBorderColor en FocusedBorderThickness.

  Notitie

  Met de Tab-toets navigeert u naar of van de keuzelijst met invoervak. Met de pijltoetsen navigeert u door de inhoud van de keuzelijst met invoervak. Met de Escape-toets sluit u de vervolgkeuzelijst wanneer deze is geopend.