Управление карточками в Power Apps

Предоставляет интерфейс отображения и редактирования для одного поля элемента управления "Форма отображения " или " Изменить форму ".

Description

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ошибка — понятное сообщение об ошибке, отображаемое для этого поля при сбое проверки.

• Это свойство задается при вызове SubmitForm .
• В сообщении описываются проблемы проверки на основе метаданных источника данных и проверки требуемого свойства карточки.

Обязательный аргумент : должен ли карточка изменять поле источника данных.

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

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

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

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

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

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

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

BorderStyle — является ли граница элемента управления твердым, дефишированным, dotted или None.

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

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

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

Допустимо. Содержит ли элемент управления формы"Карточка" или "Изменить" допустимые записи, готовые к отправке в источник данных.

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

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

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

Примеры

Примеры см. в разделе "Общие сведения о карточках данных " и "Общие сведения о макете формы данных ".

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

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

Между ними должна быть достаточная контрастность цвета:

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

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

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