Kortkontroll i PowerAppsCard control in PowerApps

Innehåller visning och redigering av ett fält i kontrollerna Visa formulär eller Redigera formulär.Provides the display and editing experience for a single field of a Display form or Edit form control.

BeskrivningDescription

Kontrollerna Visa formulär och Redigera formulär fungerar som behållare för att visa hela poster.Display form and Edit form controls act as containers for displaying and viewing entire records. Varje behållare kan innehålla en uppsättning kortkontroller som visar enskilda fält eller möjliggöra ett sätt att uppdatera dessa fält.Each container can hold a set of Card controls that display individual fields or provide a way to update those fields. Varje kort har en DataField-egenskap som anger vilka fält i posten det fungerar på.Each card has a DataField property that specifies which field of the record it works on.

Fördefinierade kort har definierats för olika datatyper och användarupplevelser.Predefined cards are defined for different data types and user experiences. Exempelvis kan det finnas ett kort för att redigera ett antal fält med en textinmatning kontroll som kan användas med tangentbordet.For example, there may be a card to edit a number field with a Text input control, which is great for use with the keyboard. Ett annat kort stöder i stället redigering av en uppsättning med hjälp av ett skjutreglage.Another card might support editing a number by using a Slider control instead. När du har valt en formulärkontroll kan du enkelt välja ett kort baserat på ett fält i rutan till höger.With the form control selected, you can, in the right-hand pane, easily select a card based on a field.

Själva korten innehåller kontroller.Cards themselves contain controls. Kontrollerna i korten avgör hur ett fält visas eller redigeras.The controls of a card make up the experience for displaying and editing a single field. Till exempel kan ett antal kort bestå av en etikett för fältets visningsnamn och en textruta för att redigera fältets värde.For example, a number card may consist of a Label control to provide the display name of the field and a Text input control to provide an editor for the value of the field. Kortet kan också ha en etikett som visar eventuella verifieringsfel och en etikett för vanliga asterisker som visar att fält är obligatoriska.The card may also have a Label control that shows any validation errors that occur and a Label control for the common asterisk to indicate that a field is required.

Du kan bland annat anpassa kontrollerna av ett fördefinierat kort genom att ändra dess storlek, flytta, dölja den, lägga till kontroller.You can customize the controls of a predefined card by resizing it, moving it, hiding it, adding controls to it, and making other changes. Du kan också starta med ett helt tomt kort, ett "anpassat kort", som du kan redigera med kontroller från grunden.You can also start with an entirely blank card, a "custom card", to which you add controls from scratch.

Fördefinierade kort är låsta som standard.Predefined cards are locked by default. Du kan endast ändra vissa egenskaper eller kontroller i kortet och du kan inte ta bort ett låst kort.In a locked card, you can modify only certain properties of the card or the controls within the card, and you can't delete a locked card. Du kan visa se om kortet är låst och låsa upp det på fliken Visa i vyn Avancerad.You can show the card lock and unlock it on the View tab of the Advanced view. Om en egenskap är låst och kan inte ändras visas den med en låsikon bredvid dess namn.If a property is locked and can't be modified, it appears with a lock icon next to its name. 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.Unlocking a card is an advanced activity and should be done with care, because automatic formula generation will no longer occur for the card, and you can't relock a card.

Inom formulärets behållare är posten ThisItem tillgänglig och innehåller alla fält i posten.Within the form's container, the ThisItem record is available and contains all the fields of the record. Till exempel, kortets standard egenskapen är ofta ThisItem.FieldName.For example, the card's Default property is often set to ThisItem.FieldName.

Du kan använda referensen överordnad för att konfigurera en kontroll om du vill referera till egenskaperna för ett kort.You can use the Parent reference to configure a control to reference the properties of a card. 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.For example, a control should use Parent.Default to read the initial state of the field from the data source. 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.By using Parent instead of directly accessing the information that you want, the card is better encapsulated, and you can change it to a different field without breaking internal formulas.

Se Förstå datakort för exempel på hur du anpassar, låser upp och skapar kort.See Understand data cards for examples of how to customize, unlock, and create cards.

NyckelegenskaperKey properties

DataField – namnet på fältet i en post som det här kortet visar och redigerar.DataField – The name of the field within a record that this card displays and edits.

  • Ange namnet som en enda statisk sträng som omges av dubbla citattecken (till exempel "Name"), inte en formel.Specify the name as a single static string that's enclosed in double quotation marks (for example, "Name"), not a formula.
  • Dela upp ett kort genom att lämna egenskapen DataField tom.Unbind a card by setting its DataField property blank. Egenskaperna Giltig och Uppdatering ignoreras för obundna kort.The Valid and Update properties are ignored for unbound cards.

Default – Ursprungsvärdet för en kontroll innan det ändras av användaren.Default – The initial value of a control before it is changed by the user.

  • 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.For each control in a card, set this property to Parent.Default to refer to the default value of the field according to the data source. Till exempel ange standard egenskapen för skjutreglaget som Parent.Default så att användaren börjar med ett allmänt värde för skjutreglaget.For example, set a slider's Default property to Parent.Default to ensure that the user starts with a generic value for that slider.

DisplayMode – Värdena kan vara Edit, View eller Disabled.DisplayMode – Values can be Edit, View, or Disabled. Kontrollerar huruvida kontrollen i kortet ska tillåta indata från användaren (Redigera), bara visar data (Visa) eller är inaktiverad (Inaktiverad).Configures whether the control inside the card allows user input (Edit), only displays data (View) or is disabled (Disabled).

  • 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.Allows a single card to be used in both edit and view forms, by configuring this property, which is tied to the Form's behavior by default.
  • I visningsläge visar underordnade kontroller, som textinmatning, listrutor och datumväljare, endast textvärdet och återger inte några interaktiva element eller dekorationer.In View mode, child controls such as Text input, Drop down, Date Picker will only display the text value and will not render any interactive elements or decorations.

DisplayName – användarvänligt namn för ett fält i en datakälla.DisplayName – The user friendly name for a field in a data source.

  • Funktionen DataSourceInfo innehåller metadata från datakällan.The DataSourceInfo function provides this metadata from the data source.
  • Kontroller i kortet ska använda Parent.DisplayName för att referera till namnet på fältet.Controls within the card should use Parent.DisplayName to refer to the name of the field.

Fel – ett användarvänligt felmeddelande visas för det här fältet när valideringen misslyckas.Error – The user friendly error message to display for this field when validation fails.

  • Den här egenskapen anges när SubmitForm anropas.This property is set when SubmitForm is called.
  • Meddelandet beskrivs problem med verifieringen baserat på datakällans metadata och kontroll av kortet egenskap Obligatoriskt.The message describes validation problems based on the data source's metadata and checking the card's Required property.

Obligatoriskt – om ett kort måste ha ett visst värde när ett fält redigeras.Required – Whether a card, editing the field of a data source, must contain a value.

  • Funktionen DataSourceInfo innehåller metadata från datakällan.The DataSourceInfo function provides the required metadata from the data source.
  • Kontroller i kortet ska använda Parent.Required för att avgöra om det kortfältet är obligatoriskt.Controls within the card should use Parent.Required to determine whether that card's field is required.

Uppdatera – värdet för att skriva tillbaka till datakällan för ett fält.Update – The value to write back to the data source for a field.

  • 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.Use this property's formula to pull the values from the edit controls of the card in order to write back to the data source. Till exempel, ange kortets egenskap Uppdatera Slider.Value för att uppdatera datakällan med ett värde från skjutreglaget i kortet.For example, set a card's Update property to Slider.Value to update the data source with a value from the slider in that card.

Width – Avståndet mellan kontrollens högra och vänstra kanter.Width – The distance between a control's left and right edges.

WidthFit – Om en kontroll automatiskt expanderar vågrätt för att fylla tomrummet i en behållarkontroll, t.ex. en Redigera formulär-kontroll.WidthFit – Whether a control automatically grows horizontally to fill any empty space in a container control such as an Edit form control. Om flera kort har värdet true för den här egenskapen fördelas tomrummet mellan dem.If multiple cards have this property set to true, the space is divided between them. Mer information finns i Förstå dataformulärlayout.For more information, see Understand data form layout.

Ytterligare egenskaperAdditional properties

BorderColor – En kontrolls kantlinjefärg.BorderColor – The color of a control's border.

BorderStyle – Om en kontrolls kantlinje är solid, streckad, prickad eller ingen.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – Tjockleken på en kontrolls kantlinje.BorderThickness – The thickness of a control's border.

Fill – Bakgrundsfärgen i en kontroll.Fill – The background color of a control.

Height – Avståndet mellan kontrollens övre och nedre kanter.Height – The distance between a control's top and bottom edges.

Valid – om en kort eller kontrollen redigera formulär innehåller giltiga värden som är redo att skickas till datakällan.Valid – Whether a Card or Edit form control contains valid entries, ready to be submitted to the data source.

Visible – Om en kontroll visas eller är dold.Visible – Whether a control appears or is hidden.

X – Avståndet mellan kontrollens vänstra kant och den överordnade behållarens vänstra kant (skärmen om det inte finns någon överordnad behållare).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container). 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.For a Card control in a container that has multiple columns, this property determines the column in which the card appears.

Y – Avståndet mellan kontrollens övre kant och den överordnade behållarens övre kant (skärmen om det inte finns någon överordnad behållare).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container). 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.For a Card control in a container that has multiple rows, this property determines the row in which the card appears.

ExempelExamples

Exempel finns i Förstå datakort och Förstå dataformulärlayout.See Understand data cards and Understand data form layout for examples.