HighlightColor – подсветка контролов
Можно программно изменять подсветку контролов, которые в системе отображаются в виде:
•полей и связаны со свойствами типа «Перечисление», «Ссылка», «Строка», «Текст», «Дата», «Целое», «Вещественное»;
•таблиц, связаны со свойством типа «Коллекция» и имеют тип Редактор свойства-коллекции.
Подсветка позволяет привлечь внимание пользователя к полю в карточке или к ячейке в таблице. Например, если сумма договора больше 100 000, то контрол с суммой можно сделать красным.
Примечание. Подсвечивать контролы можно только для веб-клиента.
Для настройки подсветки используется свойство State.Properties.<Имя свойства>.HighlightColor, в котором можно использовать стандартные цвета из палитры и задавать свои. Поддерживается широкая палитра цветов подсветки, которая доступна с помощью Colors.Common (общие цвета).
Примечание. Чтобы поля, которые видит пользователь, были не слишком многоцветными и разнородными, для подсветки рекомендуется использовать набор определенных цветов, например, зеленый (Colors.Common.Green), желтый (Colors.Common.Yellow), красный (Colors.Common.Red).
Чтобы убрать подсветку поля, используйте метод Colors.Empty – цвет не задан.
Пример 1. Подсветка контрола зеленым цветом в карточке документа
// Подсветить контрол, связанный со свойством Addressee (Адресат).
_obj.State.Properties.Addressee.HighlightColor = Colors.Common.Green;
Пример 2. Удаление подсветки контрола в карточке документа
// Удалить подсветку контрола, связанного со свойством Addressee (Адресат).
_obj.State.Properties.Addressee.HighlightColor = Colors.Empty;
Пример 3. Подсветка ячейки таблицы
// Подсветить первую ячейку таблицы синим цветом.
_obj.StatusesCollection.FirstOrDefault().State.Properties.Name.HighlightColor = Colors.Common.Blue
Пример 4. Подсветка столбца таблицы
// Подсветить столбец с именем, указанным в свойстве Name, зеленым цветом.
_obj.State.Properties.StatusesCollection.Properties.Name.HighlightColor = Colors.Common.Green
Пример 5. Подсветка всех полей таблицы
// Подсветить все ячейки таблицы желтым цветом.
_obj.State.Properties.Statuses.HighlightColor = Colors.Common.Yellow
© Компания Directum, 2024 |