Элемент управления Карточка в Power Apps

Позволяет отображать и редактировать одно поле в элементе управления Форма отображения или Форма редактирования.

Описание

Элементы управления Форма отображения и Форма редактирования выполняют функции контейнеров для отображения и просмотра записей. Каждый контейнер может содержать набор элементов управления Карточка для отображения отдельных полей или обновления этих полей. Каждая карточка имеет свойство DataField, которое указывает, для какого поля записи она применяется.

Существуют стандартные карточки для разных типов данных и режимов работы. Например, может быть карточка для редактирования числового поля с элементом управления Ввод текста, с которым очень удобно работать с помощью клавиатуры. Другая карточка может поддерживать редактирование числа с помощью элемента управления Ползунок. Когда выбран элемент управления формой, вы можете легко выбрать карточку по нужному полю на панели справа.

Карточки сами содержат элементы управления. Элементы управления карточки предоставляют интерфейс для отображения и редактирования одного поля. Например, номер карточки может состоять из элемента управления Подпись, который отображает имя поля, и другого элемента управления Ввод текста для редактирования значения поля. Карточка может также иметь элемент управления Подпись, в котором отображаются все возникающие ошибки при проверке, и элемент управления Подпись для отображения звездочки, которая указывает, что поле является обязательным.

Вы можете настраивать элементы управления для ранее определенной карточки, например изменяя их размер или положение, скрывая отображение или добавляя новые элементы управления и т. п. Также вы можете начать работу с пустой "пользовательской" карточки и самостоятельно добавить в нее все нужные элементы.

Стандартные карточки по умолчанию заблокированы. В заблокированной карточке можно изменить только некоторые свойства самой карточки или элементов управления. Кроме того, заблокированную карточку нельзя удалить. Вы можете отобразить состояние блокировки и разблокировать карточку на вкладке Представление в представлении Дополнительно. Если свойство заблокировано, то есть его нельзя изменять, рядом с его именем отображается значок блокировки. Разблокирование карточки предназначено для опытных пользователей. Используйте его с осторожностью, поскольку после разблокирования для карточки не будут автоматически создаваться формулы, и эту карточку невозможно заблокировать снова.

В контейнере формы существует запись ThisItem, которая содержит все поля записи. Например, свойство карточки Default часто имеет значение ThisItem.FieldName.

Вы можете использовать ссылку на родительский элемент Parent, чтобы настроить элемент управления, использующий свойства карточки. Например, элемент управления Parent.Default следует использовать для чтения начального состояния поля из источника данных. Если использовать элемент Parent вместо прямого доступа к данным, карточка будет лучше инкапсулирована, и вы сможете преобразовать ее в другое поле без нарушения внутренних формул.

В разделе Общие сведения о карточках данных вы найдете примеры настройки, разблокирования и создания карточек.

Ключевые свойства

DataField — имя поля в записи, которое позволяет просматривать и редактировать эту карточку.

• Укажите имя в формате единой статической строки, заключенной в двойные кавычки (например, "Name"). Не используйте формулы.
• Чтобы отменить привязку карточки, установите для ее свойства DataField пустое значение. Свойства Valid и Update игнорируются для несвязанных карточек.

Default  — начальное значение элемента управления до его изменения пользователем.

• Для каждого элемента управления в карточке присвойте этому свойству значение Parent.Default, чтобы они использовали значения по умолчанию для соответствующего источника данных. Например, если для свойства ползунка Default установить значение Parent.Default, пользователь будет начинать работу со стандартного значения для этого ползунка.

DisplayMode — возможные значения: Edit, View или Disabled. В зависимости от значения этого режима элемент управления в карточке разрешает пользователю вводить данные (Edit), только отображает данные (View) или элемент вообще отключен (Disabled).

• Этот режим позволяет использовать одну карточку в формах редактирования и просмотра одновременно. Для этого нужно настроить это свойство, привязанное к поведению формы по умолчанию.
• В режиме Просмотр дочерние элементы управления, такие как Ввод текста, Раскрывающийся список, Средство выбора даты, отображают только текст, а не интерактивные элементы или элементы оформления.

DisplayName — понятное имя для поля в источнике данных.

• Функция DataSourceInfo предоставляет эти метаданные из источника данных.
• Для элементов управления в карточке следует использовать Parent.DisplayName, чтобы использовать имя поля.

Error — понятное пользователю сообщение об ошибке, которое будет отображаться для этого поля при сбое проверки.

• Это свойство задается при вызове SubmitForm.
• Сообщение описывает проблемы проверки, используя метаданные источника данных и свойство Required карточки.

Required — обязательно ли указывать значение для карточки при редактировании поля источника данных.

• Функция DataSourceInfo предоставляет нужные метаданные из источника данных.
• Для элементов управления в карточке следует использовать Parent.Required, чтобы определить, является ли поле этой карточки обязательным.

Update — значение, которое будет записано в источник данных для этого поля.

• Используйте формулу этого свойства для извлечения значений из элементов управления, используемых в карточке для редактирования и записи значения в источник данных. Например, установите для свойства Update значение Slider.Value, чтобы записать в источник данных значение, установленное на ползунке в текущей карточке.

Width  — расстояние между левым и правым краями элемента управления.

WidthFit — позволяет включить автоматическое изменение размера элемента управления по горизонтали для заполнения пустого пространства в контейнере, например в элементе управления Форма редактирования. Если для нескольких карт этому свойству присвоено значение true, то пространство распределяется между ними. Дополнительные сведения о формах данных см. в статье Общие сведения о макете формы данных.

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

BorderColor  — цвет границы элемента управления.

BorderStyle  — стиль границы элемента управления: Solid, Dashed, Dotted или None.

BorderThickness  — толщина границы элемента управления.

Fill  — цвет фона элемента управления.

Height  — расстояние между верхним и нижним краями элемента управления.

Valid —содержит ли элемент управления Карточка или Форма редактирования допустимые значения, готовые к отправке в источник данных.

Visible — определяет, отображается элемент управления или он скрыт.

X  — расстояние между левым краем элемента управления и левым краем его родительского контейнера (или экрана, если родительского контейнера нет). Для элемента управления Карточка в контейнере с несколькими столбцами данное свойство определяет столбец, в котором отображается карточка.

Y  — расстояние между верхним краем элемента управления и верхним краем его родительского контейнера (или экрана, если родительского контейнера нет). Для элемента управления Карточка в контейнере с несколькими строками данное свойство определяет строку, в которой отображается карточка.

Примеры

С примерами можно ознакомиться в разделах Общие сведения о карточках данных и Общие сведения о макете формы данных.

Руководство по настройке специальных возможностей

Контрастность цветов

Необходимо настроить достаточный контраст для следующих элементов:

• Fill и все дочерние элементы управления. Например, если карточка содержит элемент управления Подпись и метка имеет прозрачное заполнение, свойство Fill карточки становится цветом фона для метки. Таким образом, нужно обеспечить достаточный контраст между свойством Fill карточки и свойством Color метки.

Поддержка средства чтения с экрана

• Должно присутствовать свойство DisplayName.