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

Описание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

BorderStyle — стиль границы элемента управления: Сплошная, Штриховая, Пунктирная или Отсутствует.

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

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

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

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

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

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

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

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

Примеры

Примеры см. в статье содержащей общие сведения о карточках данных.