Besturingselement Kaart in Power Apps

Gebruik dit besturingselement voor het weergeven en bewerken van één veld van een besturingselement Formulier weergeven of Formulier bewerken.

Beschrijving

De besturingselementen Formulier weergeven en Formulier bewerken fungeren als containers voor het weergeven en bewerken van volledige records. Elke container kan een set besturingselementen Kaart bevatten die afzonderlijke velden weergeven of die het mogelijk maken die velden bij te werken. Elke kaart heeft een eigenschap DataField die aangeeft om welk veld van de record het gaat.

Er zijn vooraf gedefinieerde kaarten voor verschillende gegevenstypen en gebruikerservaringen. Zo is er een kaart om een numeriek veld met een besturingselement Tekstinvoer te bewerken, wat handig is voor gebruik met het toetsenbord. Een andere kaart kan het bewerken van een getal met behulp van een besturingselement Schuifregelaar mogelijk maken. Als u het besturingselement in het formulier hebt geselecteerd, kunt u in het deelvenster aan de rechterkant eenvoudig een kaart selecteren op basis van een veld.

Kaarten zelf bevatten besturingselementen. De besturingselementen van een kaart bepalen de ervaring voor het weergeven en bewerken van één veld. Een numerieke kaart kan bijvoorbeeld bestaan uit een besturingselement Label voor de weergavenaam van het veld en een besturingselement Tekstinvoer voor het invoeren van de waarde van het veld. De kaart kan ook een besturingselement Label hebben waarin eventuele validatiefouten worden beschreven en een besturingselement Label voor een sterretje om aan te geven dat een veld vereist is.

U kunt de besturingselementen van een vooraf gedefinieerde kaart aanpassen door het formaat van de kaart te wijzigen, de kaart te verbergen, door er besturingselementen aan toe te voegen en door andere wijzigingen aan te brengen. U kunt ook beginnen met een volledig lege kaart, een 'aangepaste kaart', waaraan u zelf besturingselementen gaat toevoegen.

Vooraf gedefinieerde kaarten zijn standaard vergrendeld. In een vergrendelde kaart kunt u alleen bepaalde eigenschappen van de kaart of besturingselementen in de kaart wijzigen. Het is niet mogelijk om een vergrendelde kaart te verwijderen. U kunt de kaartvergrendeling weergeven en deze ontgrendelen op het tabblad Beeld van de weergave Geavanceerd. Als een eigenschap is vergrendeld en niet kan worden gewijzigd, wordt er naast de naam van de eigenschap een slotpictogram weergegeven. Het ontgrendelen van een kaart is een geavanceerde activiteit die met zorg moet worden uitgevoerd. De reden hiervoor is dat er dan niet meer automatisch een formule wordt gegenereerd voor de kaart en u een kaart niet opnieuw kunt vergrendelen.

In de container van het formulier is de record ThisItem beschikbaar met daarin alle velden van de record. Zo is de eigenschap Default van een kaart vaak ingesteld op ThisItem.veldnaam.

U kunt de verwijzing Parent gebruiken om een besturingselement te laten verwijzen naar de eigenschappen van een kaart. Zo kan een besturingselement Parent.Default gebruiken om de beginstatus van het veld uit de gegevensbron te lezen. Door Parent te gebruiken in plaats van de gewenste informatie rechtstreeks te benaderen, wordt de kaart beter ingekapseld en kunt u de kaart koppelen aan een ander veld zonder interne formules te verbreken.

Zie Informatie over gegevenskaarten voor voorbeelden van het aanpassen, ontgrendelen en maken van kaarten.

Belangrijkste eigenschappen

DataField: De naam van het veld in een record die in deze kaart wordt weergegeven en bewerkt.

• Geef de naam op als een statische tekenreeks tussen dubbele aanhalingstekens (bijvoorbeeld "Naam"), niet als een formule.
• U kunt een kaart loskoppelen door de eigenschap DataField leeg te laten. De eigenschappen Valid en Update worden genegeerd voor niet-afhankelijke kaarten.

Default: de aanvankelijke waarde van een besturingselement voordat deze door de gebruiker wordt gewijzigd.

• Voor elk besturingselement in een kaart moet u deze eigenschap instellen op Parent.Default om te verwijzen naar de standaardwaarde van het veld op basis van de gegevensbron. Stel de eigenschap Default van een schuifregelaar bijvoorbeeld in op Parent.Default om ervoor te zorgen dat de gebruiker begint met een algemene waarde voor de schuifregelaar.

DisplayMode: mogelijke waarden zijn Edit, View of Disabled. Configureert of invoer van de gebruiker in de kaart is toegestaan (Edit), alleen gegevens worden weergegeven (View) of is uitgeschakeld (Disabled).

• Door deze eigenschap te configureren, die standaard is gekoppeld aan het gedrag van het formulier, kan één kaart worden gebruikt in formulieren voor zowel bewerken als weergeven.
• In de modus View worden alleen de tekstwaarden van onderliggende besturingselementen als Tekstinvoer, Vervolgkeuzelijst, Datumkiezer weergegeven en worden niet alle interactieve elementen of versieringen weergegeven.

DisplayName: De gebruiksvriendelijke naam voor een veld in een gegevensbron.

• De functie DataSourceInfo biedt deze metagegevens aan vanuit de gegevensbron.
• Besturingselementen in de kaart moeten Parent.DisplayName gebruiken om te verwijzen naar de naam van het veld.

Error: Het foutbericht dat voor dit veld wordt weergegeven als de validatie is mislukt.

• Deze eigenschap wordt ingesteld wanneer SubmitForm wordt aangeroepen.
• Het bericht beschrijft validatieproblemen op basis van metagegevens uit de gegevensbron en een controle van de eigenschap Required van de kaart.

Required: Bepaalt of een kaart voor het bewerken van het veld van een gegevensbron een waarde moet bevatten.

• De functie DataSourceInfo biedt de vereiste metagegevens aan vanuit de gegevensbron.
• Besturingselementen in de kaart moeten Parent.Required gebruiken om te bepalen of het veld van deze kaart vereist is.

Update: De waarde die moet worden teruggeschreven naar de gegevensbron voor een veld.

• Gebruik de formule van deze eigenschap om de waarden op te halen uit de besturingselementen voor bewerken van de kaart om deze terug te schrijven naar de gegevensbron. Stel de eigenschap Update van een kaart bijvoorbeeld in op Schuifregelaar.Value om de gegevensbron bij te werken met een waarde van de schuifregelaar in deze kaart.

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

WidthFit: Bepaalt of een besturingselement automatisch in de breedte wordt aangepast om lege ruimte op te vullen in een containerbesturingselement, zoals een besturingselement Formulier bewerken. Als deze eigenschap voor meerdere kaarten is ingesteld op true, wordt de ruimte over de kaarten verdeeld. Zie De indeling van een gegevensformulieren begrijpen voor meer informatie.

Aanvullende eigenschappen

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.

Fill: de achtergrondkleur van een besturingselement.

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

Valid: geeft aan of het besturingselement Kaart of Formulier bewerken geldige vermeldingen bevat die kunnen worden verzonden naar de gegevensbron.

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

X: de afstand tussen de linkerrand van een besturingselement en de linkerrand van de bovenliggende container (het scherm als er geen bovenliggende container is). Als u een besturingselement Kaart hebt in een container met meerdere kolommen, bepaalt deze eigenschap de kolom waarin de kaart wordt weergegeven.

Y: de afstand tussen de bovenrand van een besturingselement en de bovenrand van de bovenliggende container (het scherm als er geen bovenliggende container is). Als u een besturingselement Kaart hebt in een container met meerdere rijen, bepaalt deze eigenschap de rij waarin de kaart wordt weergegeven.

Voorbeelden

Zie Gegevenskaarten begrijpen en De indeling van een gegevensformulier begrijpen voor voorbeelden.

Richtlijnen voor toegankelijkheid

Kleurcontrast

Er moet voldoende kleurcontrast zijn tussen:

• Fill en eventuele onderliggende besturingselementen. Als een kaart bijvoorbeeld een Label bevat en het label een transparante opvulling heeft, wordt de Fill van de kaart effectief de achtergrondkleur voor het label. Er moet daarom voldoende contrast zijn tussen de Fill van de kaart en de Color van het label.

Ondersteuning voor schermlezer

• DisplayName moet aanwezig zijn.