Описание стандартных элементов управления

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

Каждый элемент управления обладает набором атрибутов для настройки использования его в разметке карточки. Общие для всех элементов атрибуты перечислены в разделе Общие свойства элементов управления. Индивидуальные настройки элементов (при их наличии) включены в разделы с названием элементов управления.

Общие свойства элементов управления

Перечисленные ниже свойства имеются у большинства элементов управления, а некоторые, например, Имя — у всех.

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

Общие

Имя

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

Тип

Тип элемента (только для чтения).

Внешний вид

Автовыравнивание метки

Регулирует выравнивание метки элемента (выравнивать автоматически или нет).

  • Своё — использовать для отдельных длинных меток на разметке.

  • По остальным — все метки выравниваются автоматически с учетом их длины.

Видимость метки

Регулирует отображение метки (показывать/не показывать):

  • Да — текстовая метка отображается.

  • Нет — текстовая метка скрыта.

Местоположение метки

Регулирует отображение метки относительно элемента управления. По умолчанию метка расположена слева. Возможные варианты расположения:

  • Слева.

  • Справа.

  • Сверху.

  • Снизу.

Подсказка

Позволяет ввести текст всплывающей подсказки к элементу.

Показывать границу

Определяет, будет ли показана граница поля элемента (если это позволяет тип элемента).

Значения свойства Показывать границу будет применено ко всем разметкам карточки, а не только к настраиваемой разметке.
Показывать границу в режиме только для чтения

Определяет, будет ли показана граница поля элемента (если это позволяет тип свойства) в карточке, открытой только для чтения. Свойство активно всегда, однако применяется только если значение атрибута Показывать границу задано как True.

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

Текст метки, отображаемой рядом с элементом управления, по умолчанию — Свойство:.

Цвет фона

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

Цвет шрифта

Определяет цвет шрифта, используемого в элементе управления.

Цвет шрифта метки

Определяет цвет шрифта, используемого для вывода метки.

Шрифт

Определяет шрифт, используемый в элементе управления.

Шрифт метки

Определяет шрифт, используемый для вывода метки.

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

Поведение

Видимость

Определяет способ отображения элемента управления:

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

  • Пустая ячейка — элемент не отображается, на месте элемента в карточке будет пустое пространство, соответствующее элементу по размерам.

  • Невидимый — элемент не отображается, пользователи не будут знать о существовании данного элемента.

Ограничения:

  • Нельзя установить значение Невидимый для элемента разметки внутри группы, если он является единственным или последним видимым.

  • Нельзя переместить из группы единственный (последний) видимый элемент разметки, в которой есть хотя бы один невидимый элемент разметки.

Индекс быстрого поиска

Определяет количество символов, после ввода которых будет выполнен быстрый поиск подходящих значений в соответствующем справочнике. Значение поля — целое положительное число. Минимальное значение — 1. Значение по умолчанию — 3.

Значение по умолчанию

Определяет значение поля, которое будет установлено при создании нового экземпляра карточки. Система будет обрабатывать только корректные значения.

Для элементов Дата, Дата/Время и Время значение по умолчанию может быть задано двумя способами:

  • Без смещения, опциями Сегодня или Сейчас, выбираемыми из раскрывающегося списка поля Значение по умолчанию.

  • Со смещением относительно опций Сегодня или Сейчас.

Чтобы задать такое значение:

  1. Выберите из раскрывающегося списка опцию Сегодня или Сейчас.

  2. Вручную введите в поле значение смещения в формате Сегодня (Сейчас) +/- D(Д)/H(Ч)/M(М), где D(Д) — дни, H(Ч) — часы, M(М) — минуты (например, запись Сегодня+2д-15м будет интерпретирована как 0.00 часов текущих суток + 2 дня (48 часов)-15 минут).

Для элементов Число и Целое число по умолчанию используется пустое значение поля. При данной настройке в экземпляре карточки значение поля будет пустым.

Обязательное

Определяет, требуется ли заполнение данного поля перед сохранением карточки.

  • Да — сохранение карточки будет невозможно, если соответствующее поле не заполнено. Пользователю будет выдано соответствующее сообщение.

Переходить по TAB

Определяет пользовательскую последовательность очередности обхода карточки по кнопке Tab. Подробное описание настройки см. в этом пункте.

  • Да — переход по кнопке TAB разрешён.

Порядок обхода

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

Только для чтения

Определяет доступность данного элемента для редактирования. Для более гибкой настройки рекомендуется пользоваться настройкой ролевой модели. Данный атрибут позволяет жестко запретить редактирование элемента управления, но им можно воспользоваться, например, из скриптов.

Данные

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

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

Для карточек с расширенной схемой (имеющей дополнительные разделы/поля, кроме настраиваемых свойств), можно использовать атрибутивный поиск.

Источник данных

Определяет раздел карточки, содержащий поле, к которому привязывается элемент управления. После заполнения этого свойства в категории, свойство Элемент данных становится доступным для изменения.

Можно создать расширенную секцию из поля, выбрать секцию или поле из списка или указать расширенную секцию или поле.

Операция редактирования

Определяет поведение поля карточки в зависимости от поведения связанной с ним операции. Связанная операция либо создаётся при настройке атрибута, либо выбирается из Справочника состояний.

После определения операции, поведение (доступ) настраивается в Конструкторе состояний и Конструкторе ролей. Для полей, добавленных на разметку системного (или дочернего от системного) вида не рекомендуется указывать операцию редактирования, так как Ролевая модель не обрабатывает системные виды карточек.

Элемент данных

Определяет поле карточки, к которому привязывается элемент управления. Можно создать расширенное поле в выбранной секции.

Свойства Ссылка и Поле ссылки используются элементами управления Строка, Текст, Время, Дата, Дата/Время, Да/Нет, Целое число, Число.

С помощью свойств можно реализовать, например, следующий сценарий: в ссылке "сотрудник" (с выбором значения из справочника сотрудников) выбрать значение "Иванов И.И.", в поле "Tel" автоматически подставится телефон Иванова, указанный в справочнике сотрудников.

В данном случае Ссылка == поле в разметке "выберите сотрудника", а Поле ссылки "Местный телефон" — значение этого поля из справочника сотрудников, которое будет сохраняться в карточке.

Настройка локализации

Локализованные названия могут быть добавлены для следующих общих свойств:

Добавить локализованные названия свойств можно в окне, открываемом по нажатию на кнопку Земной шар справа от поля.

Для свойств Текст метки или Подсказка будет открыто окно Локализация отображаемого значения.

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

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

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

Добавление локализации для свойств "Текст метки" или "Подсказка"
Рисунок 1. Добавление локализации для свойств "Текст метки" или "Подсказка"