Как изменить цвет ячейки в таблице 1С

Изменить цвет ячейки в таблице 1С можно несколькими способами — выбор зависит от того, где находится таблица: это динамический список на форме, таблица значений, табличный документ или печатная форма. У каждого варианта свои инструменты: условное оформление формы, программное обращение к свойству «ЦветФона» или «ЦветТекста», настройка оформления в конструкторе СКД.

Чаще всего задача возникает у пользователей, которые хотят подсветить строки с определёнными условиями — например, просроченные документы, отрицательные остатки или контрагентов с задолженностью. Разработчикам же нужно уметь раскрашивать ячейки программно в обработчиках событий формы и при формировании табличных документов.

Ниже разобраны все рабочие способы: от простого условного оформления без программирования до кода на встроенном языке 1С. Для каждого метода указаны условия применения, ограничения и типичные ошибки.

Какой способ выбрать в зависимости от типа таблицы

Перед изменением цвета определите, с каким объектом работаете. В 1С «таблицей» называют несколько разных сущностей, и методы для них не взаимозаменяемы.

Таблица формы (динамический список, таблица значений, табличная часть) оформляется через условное оформление формы или программно в обработчиках событий. Табличный документ — это результат для печати и просмотра, его ячейки красятся обращением к области. Отчёт на СКД оформляется в настройках схемы компоновки данных.

Условное оформление формы без программирования

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

Откройте форму в конфигураторе, найдите в дереве элементов нужную таблицу, затем перейдите к свойству «УсловноеОформление» самой формы (оно есть у корневого элемента формы). Добавьте новый элемент настройки и заполните три части: оформление (какой цвет применить), условие (когда применять) и оформляемые поля (какие колонки таблицы красить).

1. 1
   Откройте форму списка или документа в конфигураторе.
2. 2
   Выделите корневой элемент формы и откройте свойство «Условное оформление».
3. 3
   Добавьте элемент, в поле «Оформление» задайте Цвет фона или Цвет текста.
4. 4
   В поле «Условие» добавьте отбор, например: СуммаДокумента Больше 100000.
5. 5
   В поле «Оформляемые поля» укажите колонки таблицы, которые нужно подсветить.
6. 6
   Сохраните конфигурацию и проверьте результат в режиме предприятия.

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

Программное изменение цвета ячейки

Когда условие сложное — например, цвет зависит от вычислений, обращения к другим данным или текущей даты, — условного оформления недостаточно. Тогда цвет назначается кодом.

Для динамических списков используется событие «ПриПолученииДанныхНаСервере», где доступна коллекция оформления строк. Для табличных полей обычных форм применяется обработчик «ПриВыводеСтроки», в котором у объекта «ОформлениеСтроки» есть свойства ЦветФона и ЦветТекста.

Процедура СписокПриПолученииДанныхНаСервере(ИмяЭлемента, Настройки, Строки)
    Для Каждого КлючИЗначение Из Строки Цикл
        ДанныеСтроки = КлючИЗначение.Значение.Данные;
        Если ДанныеСтроки.СуммаДокумента > 100000 Тогда
            КлючИЗначение.Значение.Оформление["СуммаДокумента"].УстановитьЗначениеПараметра("ЦветФона", WebЦвета.СветлоЖелтый);
        КонецЕсли;
    КонецЦикла;
КонецПроцедуры

Цвет можно задать через системное перечисление WebЦвета, через конструктор Новый Цвет(красный, зелёный, синий) со значениями от 0 до 255, либо через стилевые цвета из коллекции ЦветаСтиля. Стили предпочтительнее, если оформление должно соответствовать общему дизайну конфигурации.

Изменение цвета ячейки в табличном документе

Табличный документ — это объект для печатных форм, отчётов и макетов. Его ячейки окрашиваются обращением к области после вывода или непосредственно в макете.

Программно цвет задаётся так: получите область методом «Область» с указанием адреса ячейки (например, «R5C3» — строка 5, колонка 3) и присвойте свойству ЦветФона нужное значение. Если цвет известен заранее и не зависит от данных, проще задать его прямо в макете табличного документа — выделите ячейку макета и установите цвет в палитре свойств.

ТабДок = Новый ТабличныйДокумент;
// ... вывод областей ...
ОбластьЯчейки = ТабДок.Область("R5C3");
ОбластьЯчейки.ЦветФона = Новый Цвет(255, 230, 230);
ОбластьЯчейки.ЦветТекста = WebЦвета.ТемноКрасный;

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

Окраска ячеек в отчётах на СКД

В отчётах на системе компоновки данных цвет ячеек настраивается через условное оформление в закладке «Настройки» конструктора. Это самый правильный способ для отчётов: пользователь может сам менять правила подсветки без участия разработчика.

В настройках отчёта откройте вкладку «Условное оформление», добавьте элемент, укажите оформление (цвет фона или текста), отбор-условие и оформляемые поля. Например, чтобы подсветить отрицательные остатки, задайте отбор «Остаток Меньше 0» и красный цвет фона для поля «Остаток».

Для программного формирования отчёта настройки оформления можно задавать из кода через объект «Настройки» компоновщика, но для большинства задач достаточно интерактивной настройки.

Типичные ошибки и их последствия

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

Ещё одна частая ситуация: разработчик красит ячейки в обычной форме через ПриВыводеСтроки, а после перевода конфигурации на управляемые формы код перестаёт работать — события и объекты оформления там другие.

Проверка результата и ограничения

После настройки проверьте окраску на реальных данных с разными значениями: граничных, пустых и типовых. Убедитесь, что подсветка появляется и исчезает при изменении условий, а не «застревает» после первого срабатывания.

Учитывайте ограничение доступности: яркие или близкие по тону цвета могут быть неразличимы для пользователей с особенностями цветовосприятия. Дополняйте цветовую индикацию текстом или значком, если подсветка несёт важный смысл.

Часто задаваемые вопросы