Kontrolka karty w usłudze PowerAppsCard control in PowerApps

Umożliwia wyświetlanie i edytowanie dla jednego pola kontrolki Wyświetlanie formularza lub Edytowanie formularza.Provides the display and editing experience for a single field of a Display form or Edit form control.

OpisDescription

Kontrolki Wyświetlanie formularza i Edytowanie formularza działają jak kontenery do wyświetlania i przeglądania całych rekordów.Display form and Edit form controls act as containers for displaying and viewing entire records. Każdy kontener może zawierać zestaw kontrolek Karta, które wyświetlają poszczególne pola lub udostępniają sposób aktualizowania tych pól.Each container can hold a set of Card controls that display individual fields or provide a way to update those fields. Każda karta właściwość DataField, która określa pola rekordu, dla których ona działa.Each card has a DataField property that specifies which field of the record it works on.

Wstępnie zdefiniowane karty są określone dla różnych typów danych i wymagań użytkownika.Predefined cards are defined for different data types and user experiences. Na przykład może istnieć karta do edytowania pola numerycznego z kontrolką Wprowadzanie tekstu, która doskonale nadaje się do użycia z klawiaturą.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. Inna karta może obsługiwać edytowanie liczby za pomocą kontrolki Suwak.Another card might support editing a number by using a Slider control instead. Po wybraniu kontrolki formularza możesz w okienku po prawej stronie łatwo wybrać kartę na podstawie pola.With the form control selected, you can, in the right-hand pane, easily select a card based on a field.

Same karty zawierają kontrolki.Cards themselves contain controls. Kontrolki karty tworzą środowisko do wyświetlania i edytowania pojedynczego pola.The controls of a card make up the experience for displaying and editing a single field. Na przykład karta liczby może zawierać kontrolkę Etykieta, aby podać nazwę wyświetlaną pola, i kontrolkę Wprowadzanie tekstu, aby dostarczyć do edytora wartość pola.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. Karta może mieć również kontrolkę Etykieta, która pokazuje wszelkie błędy walidacji, które wystąpiły, i kontrolkę Etykieta dla typowej gwiazdki, aby pokazać, że pole jest wymagane.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.

Kontrolki wstępnie zdefiniowanej karty możesz dostosować, zmieniając ich rozmiar, przenosząc je, ukrywając je, dodając do nich kontrolki i wprowadzając inne zmiany.You can customize the controls of a predefined card by resizing it, moving it, hiding it, adding controls to it, and making other changes. Możesz również rozpocząć od całkiem pustej karty, „karty niestandardowej”, do której możesz dodawać kontrolki od początku.You can also start with an entirely blank card, a "custom card", to which you add controls from scratch.

Wstępnie zdefiniowane karty są domyślnie zablokowane.Predefined cards are locked by default. Na zablokowanej karcie można modyfikować tylko niektóre właściwości karty lub kontrolek na karcie, ale nie możesz usunąć zablokowanej karty.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. Można wyświetlać blokady karty i je odblokowywać na karcie Widok widoku Zaawansowany.You can show the card lock and unlock it on the View tab of the Advanced view. Jeśli właściwość jest zablokowana i nie można jej modyfikować, prawdopodobnie jest ona wyświetlana z ikoną kłódki znajdującą się obok jej nazwy.If a property is locked and can't be modified, it appears with a lock icon next to its name. Odblokowywanie karty to zaawansowane działanie i musi być wykonywane ostrożnie, ponieważ dla karty nie nastąpi już automatyczne generowanie formuły i nie można będzie ponownie zablokować karty.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.

W kontenerze formularza dostępny jest rekord ThisItem, który zawiera wszystkie pola rekordu.Within the form's container, the ThisItem record is available and contains all the fields of the record. Na przykład właściwość karty Domyślne jest często ustawiana na ThisItem.FieldName.For example, the card's Default property is often set to ThisItem.FieldName.

Możesz użyć odwołania Nadrzędne, aby skonfigurować kontrolkę tak, aby odwoływała się do właściwości karty.You can use the Parent reference to configure a control to reference the properties of a card. Na przykład kontrolka powinna używać wartości Parent.Default, aby odczytać początkowy stan pola ze źródła danych.For example, a control should use Parent.Default to read the initial state of the field from the data source. W przypadku użycia odwołania Nadrzędne zamiast bezpośredniego dostępu do żądanych informacji karta jest lepiej hermetyzowana i możesz ją zmienić na inne pole bez naruszania wewnętrznych formuł.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.

Zobacz Omówienie kart danych, aby zapoznać się z przykładami dostosowywania, odblokowywania i tworzenia kart.See Understand data cards for examples of how to customize, unlock, and create cards.

Kluczowe właściwościKey properties

DataField — nazwa pola w rekordzie, które ta karta pozwala wyświetlać i edytować.DataField – The name of the field within a record that this card displays and edits.

  • Określ nazwę jako pojedynczy statyczny ciąg ujęty w znaki podwójnego cudzysłowu (na przykład „Nazwa”), nie formułę.Specify the name as a single static string that's enclosed in double quotation marks (for example, "Name"), not a formula.
  • Usuń powiązanie karty, ustawiając jej właściwość DataField jako pustą.Unbind a card by setting its DataField property blank. Właściwości Valid i Update są ignorowane w przypadku niepowiązanych kart.The Valid and Update properties are ignored for unbound cards.

Default — początkowa wartość kontrolki przed jej zmianą przez użytkownika.Default – The initial value of a control before it is changed by the user.

  • Dla każdej kontrolki na karcie należy ustawić tę właściwość na Parent.Default, aby odwoływała się do wartości domyślnej pola zgodnie ze źródłem danych.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. Na przykład ustaw właściwość Default suwaka na Parent.Default, aby upewnić się, że użytkownik rozpocznie od ogólnej wartości dla tego suwaka.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 — możliwe wartości to Edit, View i Disabled.DisplayMode – Values can be Edit, View, or Disabled. Konfiguruje, czy kontrolka wewnątrz karty zezwala na wprowadzanie danych wejściowych przez użytkownika (Edit), czy tylko wyświetla dane (View) lub jest wyłączona (Disabled).Configures whether the control inside the card allows user input (Edit), only displays data (View) or is disabled (Disabled).

  • Umożliwia używanie pojedynczej karty w formularzach zarówno do edycji, jak i przeglądania, konfigurując tę właściwość, która jest domyślnie powiązana z zachowaniem formularza.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.
  • W trybie Widok kontrolki podrzędne, takie jak Wprowadzanie tekstu, Lista rozwijana i Selektor dat będą wyświetlać tylko samą wartość tekstową i nie będą renderować żadnych elementów interaktywnych ani dekoracji.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 — przyjazna dla użytkownika nazwa pola źródła danych.DisplayName – The user friendly name for a field in a data source.

  • Funkcja DataSourceInfo zapewnia metadane ze źródła danych.The DataSourceInfo function provides this metadata from the data source.
  • Kontrolki w ramach karty powinny używać ustawienia Parent.DisplayName do odwoływania się do nazwy pola.Controls within the card should use Parent.DisplayName to refer to the name of the field.

Error — przyjazny dla użytkownika komunikat o błędzie do wyświetlenia dla tego pola w przypadku niepowodzenia weryfikacji.Error – The user friendly error message to display for this field when validation fails.

  • Ta właściwość jest ustawiona, gdy jest wywoływana funkcja SubmitForm.This property is set when SubmitForm is called.
  • Komunikat opisuje problemy weryfikacji na podstawie metadanych źródła danych i sprawdzania właściwości Required karty.The message describes validation problems based on the data source's metadata and checking the card's Required property.

Required — czy karta edytująca pole źródła danych musi zawierać wartość.Required – Whether a card, editing the field of a data source, must contain a value.

  • Funkcja DataSourceInfo zapewnia wymagane metadane ze źródła danych.The DataSourceInfo function provides the required metadata from the data source.
  • Kontrolki w ramach karty powinny używać ustawienia Parent.Required do ustalenia, czy to pole karty jest wymagane.Controls within the card should use Parent.Required to determine whether that card's field is required.

Update — wartość do zapisania z powrotem do źródła danych dla pola.Update – The value to write back to the data source for a field.

  • Formuła tej właściwości służy do pobierania wartości z kontrolek edycji karty w celu zapisania z powrotem do źródła danych.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. Na przykład ustaw właściwość Update karty na Slider.Value, aby zaktualizować źródło danych wartością z suwaka na tej karcie.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 — odległość między lewą i prawą krawędzią kontrolki.Width – The distance between a control's left and right edges.

WidthFit — czy kontrolka automatycznie rozszerza się w poziomie, aby wypełnić całe puste miejsce w kontenerze kontrolki, takiej jak kontrolka Edytowanie formularza.WidthFit – Whether a control automatically grows horizontally to fill any empty space in a container control such as an Edit form control. Jeśli wiele kart ma tę właściwość ustawioną na wartość true, miejsce jest dzielone między nimi.If multiple cards have this property set to true, the space is divided between them. Aby uzyskać więcej informacji, zobacz Omówienie układu formularza danych.For more information, see Understand data form layout.

Dodatkowe właściwościAdditional properties

BorderColor — kolor obramowania kontrolki.BorderColor – The color of a control's border.

BorderStyle — rodzaj obramowania kontrolki: Solid (ciągłe), Dashed (kreskowane), Dotted (kropkowane) lub None (brak).BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness — grubość obramowania kontrolki.BorderThickness – The thickness of a control's border.

Fill — kolor tła kontrolki.Fill – The background color of a control.

Height — odległość między górną i dolną krawędzią kontrolki.Height – The distance between a control's top and bottom edges.

Valid — czy kontrolka Karta lub Edytowanie formularza zawiera prawidłowe wpisy, gotowe do wysłania do źródła danych.Valid – Whether a Card or Edit form control contains valid entries, ready to be submitted to the data source.

Visible — czy kontrolka jest widoczna, czy ukryta.Visible – Whether a control appears or is hidden.

X — odległość między lewą krawędzią kontrolki a lewą krawędzią jej kontenera nadrzędnego (ekranu, jeśli brak kontenera nadrzędnego).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container). W przypadku kontrolki Karta w kontenerze, który zawiera wiele kolumn, ta właściwość określa kolumnę, w której zostanie wyświetlona karta.For a Card control in a container that has multiple columns, this property determines the column in which the card appears.

Y — odległość między górną krawędzią kontrolki a górną krawędzią kontenera nadrzędnego (ekranu, jeśli brak kontenera nadrzędnego).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container). W przypadku kontrolki Karta w kontenerze, który zawiera wiele wierszy, ta właściwość określa wiersz, w którym zostanie wyświetlona karta.For a Card control in a container that has multiple rows, this property determines the row in which the card appears.

PrzykładyExamples

Aby przejrzeć przykłady, zobacz Omówienie kart danych i Omówienie układu formularza danych.See Understand data cards and Understand data form layout for examples.