Kort-kontroll i Power Apps

Innehåller visning och redigering av ett fält i kontrollerna Visa formulär eller Redigera formulär.

Beskrivning

Kontrollerna Visa formulär och Redigera formulär fungerar som Behållare för att visa hela poster. Varje Behållare kan innehålla en uppsättning Kort kontroller som visar enskilda fält eller möjliggöra ett sätt att uppdatera dessa fält. Varje kort har en DataField-egenskap som anger vilka fält i posten det fungerar på.

Fördefinierade kort har definierats för olika datatyper och användarupplevelser. Exempelvis kan det finnas ett kort för att redigera ett antal fält med en Textinmatning kontroll som kan användas med tangentbordet. Ett annat kort stöder i stället redigering av en uppsättning med hjälp av ett Reglage. När du har valt en Form-kontrollen kan du enkelt välja ett kort baserat på ett fält i rutan till höger.

Själva korten innehåller kontroller. Kontrollerna i korten avgör hur ett fält visas eller redigeras. Till exempel kan ett antal kort bestå av en Etikett för fältets visningsnamn och en Textinmatning för att redigera fältets värde. Kortet kan också ha en Etikett som visar eventuella verifieringsfel och en Etikett för vanliga asterisker som visar att fält är obligatoriska.

Du kan bland annat anpassa kontrollerna av ett fördefinierat kort genom att ändra dess storlek, flytta, dölja den, lägga till kontroller. Du kan också starta med ett helt tomt kort, ett "anpassat kort", som du kan redigera med kontroller från grunden.

Fördefinierade kort är låsta som standard. Du kan endast ändra vissa egenskaper eller kontroller i kortet och du kan inte ta bort ett låst kort. Du kan visa se om kortet är låst och låsa upp det på fliken Visa i vyn Avancerad. Om en egenskap är låst och kan inte ändras visas den med en låsikon bredvid dess namn. Att låsa upp ett kort är en avancerad åtgärd och bör göras försiktigt eftersom kortet inte längre kan generera formler automatiskt och det inte går att låsa ett kort på nytt.

Inom formulärets container är posten ThisItem tillgänglig och innehåller alla fält i posten. Till exempel, kortets Default egenskapen är ofta ThisItem.FieldName.

Du kan använda referensen överordnad för att konfigurera en kontroll om du vill referera till egenskaperna för ett kort. En kontroll ska till exempel använda Parent.Default för att läsa det ursprungliga tillståndet för fältet från datakällan. Med hjälp av överordnade i stället för direkt åtkomst till informationen som du behöver är kortet med kompakt och du kan ändra det till ett annat fält utan att bryta interna formler.

Se Förstå datakort för exempel på hur du anpassar, låser upp och skapar kort.

Nyckelegenskaper

DataField – namnet på fältet i en post som det här kortet visar och redigerar.

• Ange namnet som en enda statisk sträng som omges av dubbla citattecken (till exempel "Name"), inte en formel.
• Dela upp ett kort genom att lämna egenskapen DataField tom. Egenskaperna Valid och Update ignoreras för obundna kort.

Default – Ursprungsvärdet för en kontroll innan det ändras av användaren.

• Ange den här egenskapen som Parent.Default för alla kontroller i ett kort för att referera till fältets standardvärde enligt datakällan. Till exempel ange Default egenskapen för skjutreglaget som Parent.Default så att användaren börjar med ett allmänt värde för skjutreglaget.

DisplayMode – Värdena kan vara Edit, View eller Disabled. Kontrollerar huruvida kontrollen i kortet ska tillåta indata från användaren (Redigera), bara visar data (Visa) eller är inaktiverad (Inaktiverad).

• Genom att konfigurera den här egenskapen, som är knuten till formulärets beteendet som standard, tillåter du att ett enskilt kort används i både redigerings- och visningsformulär.
• I visningsläge visar underordnade kontroller, som Textinmatning, Listruta och Datumväljare, endast textvärdet och återger inte några interaktiva element eller dekorationer.

DisplayName – användarvänligt namn för ett fält i en datakälla.

• Funktionen DataSourceInfo innehåller metadata från datakällan.
• Kontroller i kortet ska använda Parent.DisplayName för att referera till namnet på fältet.

Error – ett användarvänligt felmeddelande visas för det här fältet när valideringen misslyckas.

• Den här egenskapen anges när SubmitForm anropas.
• Meddelandet beskrivs problem med verifieringen baserat på datakällans metadata och kontroll av kortet egenskap Required.

Required – om ett kort måste ha ett visst värde när ett fält redigeras.

• Funktionen DataSourceInfo innehåller metadata från datakällan.
• Kontroller i kortet ska använda Parent.Required för att avgöra om det kortfältet är obligatoriskt.

Update – värdet för att skriva tillbaka till datakällan för ett fält.

• Använd den här egenskapens formel för att hämta värden från kortets redigeringskontroller för att skriva tillbaka till datakällan. Till exempel, ange kortets egenskap Update till Slider.Value för att uppdatera datakällan med ett värde från reglaget på det kortet.

Width – Avståndet mellan kontrollens högra och vänstra kanter.

WidthFit – Om en kontroll automatiskt expanderar vågrätt för att fylla tomrummet i en containerkontroll, t.ex. en Redigera formulär-kontroll. Om flera kort har värdet true för den här egenskapen fördelas tomrummet mellan dem. Mer information finns i Förstå dataformulärlayout.

Ytterligare egenskaper

BorderColor – En kontrolls kantlinjefärg.

BorderStyle – Om en kontrolls kantlinje är solid, streckad, prickad eller ingen.

BorderThickness – Tjockleken på en kontrolls kantlinje.

Fill – Bakgrundsfärgen i en kontroll.

Height – Avståndet mellan kontrollens övre och nedre kanter.

Valid – om en Kort eller kontrollen Redigera formulär innehåller giltiga värden som är redo att skickas till datakällan.

Visible – Om en kontroll visas eller är dold.

X – Avståndet mellan kontrollens vänstra kant och den överordnade containerns vänstra kant (skärmen om det inte finns någon överordnad behållare). Om en Kort-kontroll finns i en Behållare som har flera kolumner bestämmer den här egenskapen vilken kolumn kortet ska visas i.

Y – Avståndet mellan kontrollens övre kant och den överordnade containerns övre kant (skärmen om det inte finns någon överordnad behållare). Om en Kort-kontroll finns i en Behållare som har flera rader bestämmer den här egenskapen vilken rad kortet ska visas i.

Exempel

Exempel finns i Förstå datakort och Förstå dataformulärlayout.

Riktlinjer för hjälpmedel

Färgkontrast

Det måste finnas tillräcklig färgkontrast mellan:

• Fyllning och eventuella underordnade kontroller. Om ett kort till exempel innehåller en Etikett och etiketten har transparent fyllning så blir kortets Fill effektivt bakgrundsfärgen för etiketten. Därför bör det vara tillräcklig kontrast mellan kortets Fill och etikettens Color.

Stöd för skärmläsare

• DisplayName måste finnas.

Anteckning

Kan du berätta om dina inställningar för dokumentationsspråk? Svara i en kort undersökning. (observera att undersökningen är på engelska)

Undersökningen tar ungefär sju minuter. Inga personuppgifter samlas in (sekretesspolicy).