Элемент управления "Карточка" в PowerAppsCard control in PowerApps

Позволяет отображать и редактировать одно поле в элементе управления Форма просмотра или Форма редактирования.Provides the display and editing experience for a single field of a Display form or Edit form control.

ОписаниеDescription

Элементы управления Форма просмотра и Форма редактирования выполняют функции контейнеров для отображения и просмотра записей.Display form and Edit form controls act as containers for displaying and viewing entire records. Каждый контейнер может содержать набор элементов управления Карточка для отображения отдельных полей или обновления этих полей.Each container can hold a set of Card controls that display individual fields or provide a way to update those fields. Каждая карточка имеет свойство DataField, которое указывает, для какого поля записи она применяется.Each card has a DataField property that specifies which field of the record it works on.

Существуют стандартные карточки для разных типов данных и режимов работы.Predefined cards are defined for different data types and user experiences. Например, может быть карточка для редактирования числового поля с элементом управления Текстовый ввод, с которым очень удобно работать с помощью клавиатуры.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. Другая карточка может поддерживать редактирование числа с помощью элемента управления Ползунок.Another card might support editing a number by using a Slider control instead. Когда выбран элемент управления формой, вы можете легко выбрать карточку по нужному полю на панели справа.With the form control selected, you can, in the right-hand pane, easily select a card based on a field.

Карточки сами содержат элементы управления.Cards themselves contain controls. Элементы управления карточки предоставляют интерфейс для отображения и редактирования одного поля.The controls of a card make up the experience for displaying and editing a single field. Например, номер карточки может состоять из элемента управления Метка, который отображает имя поля, и другого элемента управления Текстовое поле для редактирования значения поля.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. Карточка может также иметь элемент управления Метка, в котором отображаются все возникающие ошибки при проверке, или Метка для отображения звездочки, которая указывает, что поле является обязательным.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.

Вы можете настраивать элементы управления для ранее определенной карточки, например изменяя их размер или положение, скрывая отображение или добавляя новые элементы управления и т. п.You can customize the controls of a predefined card by resizing it, moving it, hiding it, adding controls to it, and making other changes. Также вы можете начать работу с пустой "пользовательской" карточки и самостоятельно добавить в нее все нужные элементы.You can also start with an entirely blank card, a "custom card", to which you add controls from scratch.

Стандартные карточки по умолчанию заблокированы.Predefined cards are locked by default. В заблокированной карточке можно изменить только некоторые свойства самой карточки или элементов управления. Кроме того, заблокированную карточку нельзя удалить.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. Вы можете отобразить состояние блокировки и разблокировать карточку на вкладке Представление в представлении Дополнительно.You can show the card lock and unlock it on the View tab of the Advanced view. Если свойство заблокировано, то есть его нельзя изменять, рядом с его именем отображается значок блокировки.If a property is locked and can't be modified, it appears with a lock icon next to its name. Разблокирование карточки предназначено для опытных пользователей. Используйте его с осторожностью, поскольку после разблокирования для карточки не будут автоматически создаваться формулы, и эту карточку невозможно заблокировать снова.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.

В контейнере формы существует запись ThisItem, которая содержит все поля записи.Within the form's container, the ThisItem record is available and contains all the fields of the record. Например, свойство карточки Default часто имеет значение ThisItem. FieldName.For example, the card's Default property is often set to ThisItem.FieldName.

Вы можете использовать ссылку на родительский элемент Parent, чтобы настроить элемент управления, использующий свойства карточки.You can use the Parent reference to configure a control to reference the properties of a card. Например, элемент управления Parent.Default следует использовать для чтения начального состояния поля из источника данных.For example, a control should use Parent.Default to read the initial state of the field from the data source. Если использовать элемент Parent вместо прямого доступа к данным, карточка будет лучше инкапсулирована, и вы сможете преобразовать ее в другое поле без нарушения внутренних формул.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.

В разделе Understand data cards (Общие сведения о карточках данных) вы найдете примеры настройки, разблокирования и создания карточек.See Understand data cards for examples of how to customize, unlock, and create cards.

Основные свойстваKey properties

DataField. Имя поля в записи, которое позволяет просматривать и редактировать эта карточка.DataField – The name of the field within a record that this card displays and edits.

  • Укажите имя в формате единой статической строки, заключенной в двойные кавычки (например, "Name"). Не используйте формулы.Specify the name as a single static string that's enclosed in double quotation marks (for example, "Name"), not a formula.
  • Чтобы отменить привязку карточки, установите для ее свойства DataField пустое значение.Unbind a card by setting its DataField property blank. Свойства Valid и Update игнорируются для несвязанных карточек.The Valid and Update properties are ignored for unbound cards.

Default. Начальное значение элемента управления до его изменения пользователем.Default – The initial value of a control before it is changed by the user.

  • Для каждого элемента управления в карточке присвойте этому свойству значение Parent.Default, чтобы они использовали значения по умолчанию для соответствующего источника данных.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. Например, если для свойства ползунка Default установить значение Parent.Default, пользователь будет начинать работу со стандартного значения для этого ползунка.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 — возможные значения: Изменение, Просмотр или Отключено.DisplayMode – Values can be Edit, View, or Disabled. В зависимости от значения этого режима элемент управления в карточке разрешает пользователю вводить данные (Изменение), только отображает данные (Просмотр) или элемент вообще отключен (Отключено).Configures whether the control inside the card allows user input (Edit), only displays data (View) or is disabled (Disabled).

  • Этот режим позволяет использовать одну карточку в формах редактирования и просмотра одновременно. Для этого нужно настроить это свойство, привязанное к поведению формы по умолчанию.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.
  • В режиме Просмотр дочерние элементы управления, такие как Ввод текста, Раскрывающийся список, Выбор даты, отображают только текст, а не интерактивные элементы или элементы оформления.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 – The user friendly name for a field in a data source.

  • Функция DataSourceInfo предоставляет эти метаданные из источника данных.The DataSourceInfo function provides this metadata from the data source.
  • Для элементов управления в карточке следует использовать Parent.DisplayName, чтобы использовать имя поля.Controls within the card should use Parent.DisplayName to refer to the name of the field.

Error. Понятное пользователю сообщение об ошибке, которое будет отображаться для этого поля при сбое проверки.Error – The user friendly error message to display for this field when validation fails.

  • Это свойство задается при вызове SubmitForm.This property is set when SubmitForm is called.
  • Сообщение описывает проблемы проверки, используя метаданные источника данных и свойство Required карточки.The message describes validation problems based on the data source's metadata and checking the card's Required property.

Required. Обязательно ли указывать значение для карточки при редактировании поля источника данных.Required – Whether a card, editing the field of a data source, must contain a value.

  • Функция DataSourceInfo предоставляет нужные метаданные из источника данных.The DataSourceInfo function provides the required metadata from the data source.
  • Для элементов управления в карточке следует использовать Parent.Required, чтобы определить, является ли поле этой карточки обязательным.Controls within the card should use Parent.Required to determine whether that card's field is required.

Update. Значение, которое будет записано в источник данных для этого поля.Update – The value to write back to the data source for a field.

  • Используйте формулу этого свойства для извлечения значений из элементов управления, используемых в карточке для редактирования и записи значения в источник данных.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. Например, установите для свойства Update значение Slider.Value, чтобы записать в источник данных значение, установленное на ползунке в текущей карточке.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 — расстояние между левым и правым краем элемента управления.Width – The distance between a control's left and right edges.

WidthFit — позволяет включить автоматическое изменение размера элемента управления по горизонтали для заполнения пустого пространства в контейнере, например в элементе управления Форма изменения.WidthFit – Whether a control automatically grows horizontally to fill any empty space in a container control such as an Edit form control. Если для нескольких карт этому свойству присвоено значение true, то пространство распределяется между ними.If multiple cards have this property set to true, the space is divided between them. Дополнительные сведения о формах данных см. в статье Общие сведения о макете формы данных в Microsoft PowerApps.For more information, see Understand data form layout.

Дополнительные свойстваAdditional properties

BorderColor — цвет границы элемента управления.BorderColor – The color of a control's border.

BorderStyle — стиль границы элемента управления: Сплошная, Штриховая, Пунктирная или Отсутствует.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness — толщина границы элемента управления.BorderThickness – The thickness of a control's border.

Fill — цвет фона элемента управления.Fill – The background color of a control.

Height — расстояние между верхним и нижним краем элемента управления.Height – The distance between a control's top and bottom edges.

Valid —содержит ли Карточка или Форма редактирования допустимые значения, готовые к отправке в источник данных.Valid – Whether a Card or Edit form control contains valid entries, ready to be submitted to the data source.

Visible определяет, отображается ли элемент управления или он скрыт.Visible – Whether a control appears or is hidden.

X — расстояние между левым краем элемента управления и левым краем его родительского контейнера (или экрана, если родительского контейнера нет).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container). Для элемента управления Карточка в контейнере с несколькими столбцами данное свойство определяет столбец, в котором отображается карточка.For a Card control in a container that has multiple columns, this property determines the column in which the card appears.

Y — расстояние между верхним краем элемента управления и верхним краем его родительского контейнера (или экрана, если родительского контейнера нет).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container). Для элемента управления Карточка в контейнере с несколькими строками данное свойство определяет строку, в которой отображается карточка.For a Card control in a container that has multiple rows, this property determines the row in which the card appears.

ПримерыExamples

С примерами можно ознакомиться в разделах Общие сведения о карточках данных и Общие сведения о макете формы данных в Microsoft PowerApps.See Understand data cards and Understand data form layout for examples.