Kontrolelementet Kort i Power Apps

Leverer oplevelsen af visning og redigering for et enkelt felt i et kontrolelement af typen Vis formular eller Rediger formular.

Beskrivelse

Kontrolelementerne Vis formular og Rediger formular fungerer som objektbeholdere til visning og redigering af hele poster. Hver objektbeholder kan indeholde et sæt kontrolelementer af typen Kort, som viser individuelle felter eller giver en metode til at opdatere de pågældende felter. Hvert kort har egenskaben DataField, der angiver, hvilket felt fra posten det fungerer på.

Der findes foruddefinerede kort til forskellige datatyper og brugeroplevelser. Eksempelvis kan der være et kort til at redigere et talfelt med et kontrolelement af typen Tekstinput, som er velegnet til brug sammen med tastaturet. Et andet kort understøtter redigering af et tal ved hjælp af et kontrolelement af typen Skyder i stedet for. Når formularkontrolelementet er markeret, kan du nemt vælge et kort i ruden til højre, som er baseret på et felt.

Kort kan selv indeholde kontrolelementer. Kontrolelementerne på et kort leverer oplevelsen af visning og redigering for et enkelt felt. Eksempelvis kan et talkort bestå af et kontrolelement af typen Mærkat med feltets viste navn og et kontrolelement at typen Tekstinput med et redigeringsværktøj til feltets værdi. Kortet kan også have et kontrolelement af typen Mærkat, der viser eventuelle valideringsfejl, der opstår, og et kontrolelement af typen Mærkat for den stjerne, der ofte bruges til at angive, at et felt er obligatorisk.

Du kan tilpasse kontrolelementerne på et foruddefineret kort ved at ændre dets størrelse, flytte det, skjule det, tilføje kontrolelementer og foretage andre ændringer. Du kan også begynde med et helt tomt kort, et "brugerdefineret kort", hvor du kan tilføje kontrolelementer fra bunden.

Foruddefinerede kort er låst som standard. På låste kort kan du kun ændre visse egenskaber for kortet eller kontrolelementerne på kortet, og du kan ikke slette et låst kort. Du kan få vist kortlåsen og låse den op på fanen Vis i visningen Avanceret. Hvis en egenskab er låst og ikke kan ændres, vises den med en låsikon ud for navnet. Det er en avanceret handling at låse et kort op, og det skal gøres med forsigtighed, da der ikke længere genereres formler automatisk for kortet, og du ikke kan låse kortet igen.

I formularens objektbeholder findes posten ThisItem, der indeholder alle postens felter. Eksempelvis er kortets egenskab Default ofte angivet til ThisItem.FieldName.

Du kan bruge referencen Parent til at konfigurere et kontrolelement til at referere til egenskaberne for et kort. Eksempelvis skal et kontrolelement bruge Parent.Default til at læse den oprindelige tilstand for feltet fra datakilden. Hvis du bruger Parent i stedet for direkte adgang til de oplysninger, du skal bruge, er kortet er mere robust, og du kan ændre det til et andet felt uden at ødelægge de interne formler.

Se eksempler på, hvordan du tilpasser, oplåser og opretter kort i Forstå datakort.

Vigtige egenskaber

DataField – Navnet på feltet i en post, som dette kort viser og redigerer.

• Angiv navnet som en enkelt statisk streng, der er omsluttet af dobbelte anførselstegn (f.eks. "Name"), og ikke en formel.
• Ophæv bindingen af et kort ved at angive egenskaben DataField til tom. Egenskaberne Valid og Update ignoreres for ubundne kort.

Default – Startværdien for et kontrolelement, før den ændres af brugeren.

• Angiv denne egenskab til Parent.Default for alle kontrolelementer på kortet, så du refererer til standardværdien for feltet i henhold til datakilden. Du kan f.eks. angive egenskaben Default for en skyder til Parent.Default for at sikre, at brugeren starter med en generisk værdi for den pågældende skyder.

DisplayMode – Værdier kan være Edit, View eller Disabled. Konfigurerer, om kontrolelementet på kortet tillader brugerinput (Edit), kun viser data (View) eller er deaktiveret (Disabled).

• Gør det muligt at bruge et enkelt kort i formularer til både redigering og visning. Dette opnås ved at konfigurere denne egenskab, der som standard er knyttet til formularens funktionsmåde.
• I tilstanden Vis viser underordnede kontrolelementer som f.eks. Tekstinput, Rulleliste eller Datovælger kun tekstværdien og ikke nogen interaktive elementer eller udsmykninger.

DisplayName – Det brugervenlige navn på et felt i en datakilde.

• Funktionen DataSourceInfo leverer disse metadata fra datakilden.
• Kontrolelementerne på kortet bør bruge Parent.DisplayName til at referere til navnet på feltet.

Error – Den brugervenlige fejlmeddelelse, der skal vises for dette felt, når valideringen mislykkes.

• Denne egenskab angives, når SubmitForm kaldes.
• Meddelelsen beskriver valideringsfejl ud fra datakildens metadata og kontrollerer egenskaben Required for kortet.

Required – Om et kort, der anvendes til redigering af et felt i en datakilde. Det skal indeholde en værdi.

• Funktionen DataSourceInfo leverer disse metadata om obligatoriske værdier fra datakilden.
• Kontrolelementerne på kortet bør bruge Parent.Required til at afgøre, om feltet er obligatorisk.

Update – Den værdi, der skal skrives tilbage til datakilden for et felt.

• Brug denne egenskabs formel til at udtrække værdier fra kortets kontrolelementer til redigering, så de kan skrives tilbage til datakilden. Eksempelvis kan du angive egenskaben Update for et kort til Slider.Value for at opdatere datakilden med en værdi fra skyderen på det pågældende kort.

Width – Afstanden mellem et kontrolelements venstre og højre kant.

WidthFit – Om et kontrolelement automatisk vokser vandret for at udfylde eventuel tom plads i et kontrolelement for objektbeholdere, f.eks. et kontrolelement af typen Rediger formular. Hvis flere kort har denne egenskab angivet til true, deles pladsen mellem dem. Du kan finde flere oplysninger under Forstå layout for dataformularer.

Flere egenskaber

BorderColor – Farven på et kontrolelements kant.

BorderStyle – Om et kontrolelements kant er Solid, Dashed, Dotted eller None.

BorderThickness – Tykkelsen på et kontrolelements kant.

Fill – Baggrundsfarven i et kontrolelement.

Height – Afstanden mellem et kontrolelements øverste og nederste kant.

Valid – Om et kontrolelement af typen Kort eller Rediger formular indeholder gyldige indtastninger, der er klar til at blive sendt til datakilden.

Visible – Om et kontrolelement vises eller skjules.

X – Afstanden mellem kontrolelementets venstre kant og venstre kant af den overordnede objektbeholder (eller skærmbilledet, hvis der ingen overordnet objektbeholder er). For et kontrolelement af typen Kort i en objektbeholder, der har flere kolonner, bestemmer denne egenskab den kolonne, som kortet vises i.

Y – Afstanden mellem kontrolelementets øverste kant og den øverste kant af den overordnede objektbeholder (eller skærmbilledet, hvis der ingen overordnet objektbeholder er). For et kontrolelement i en beholder af typen Kort, der har flere kolonner, bestemmer denne egenskab den række, som kortet vises i.

Eksempler

Se eksempler i Forstå datakort og Forstå layout for dataformularer.

Retningslinjer for tilgængelighed

Farvekontrast

Der skal være tilstrækkelig farvekontrast mellem:

• Fill og alle underordnede kontrolelementer. Hvis et kort f.eks. indeholder et kontrolelement af typen Mærkat, og denne etiket har gennemsigtig udfyldning, bliver kortets egenskab Fill etikettens baggrundsfarve. Der skal derfor være tilstrækkelig kontrast mellem kortets Fill og etikettens Color.

Understøttelse af skærmlæser

• DisplayName skal være til stede.