При разработке отчетов или печатных форм в 1С:Предприятие часто возникает задача выделить определенные данные цветом. Это может быть подсветка отрицательных остатков, выделение незаполненных полей или акцентирование внимания на важных показателях. Если отчет строится не на Системе Компоновки Данных (СКД), где условное оформление настраивается мышкой, а формируется программно через код, нам необходимо управлять свойствами ячеек напрямую.
В этой статье мы подробно разберем, как изменить цвет текста в ячейке табличного документа, проанализируем распространенные ошибки при адресации областей и рассмотрим способы оптимизации этого процесса.
Представим ситуацию: у нас есть готовый, сформированный объект типа ТабличныйДокумент (например, выведенный на форму отчета или подготовленный к печати). Нам необходимо пробежаться по его ячейкам, проверить содержимое и, если текст ячейки соответствует определенному условию (например, содержит слово "Пустой" или "⁃⁃⁃"), окрасить текст в заданный цвет.
Давайте проанализируем основные способы реализации и "подводные камни", с которыми можно столкнуться.
Этот подход предполагает, что мы сначала полностью формируем таблицу, а затем запускаем цикл для проверки всех ячеек. Именно этот способ использовал автор вопроса.
Для реализации нам понадобятся следующие методы объекта ТабличныйДокумент:
ВысотаТаблицы — возвращает количество строк в документе.ШиринаТаблицы — возвращает количество колонок.Область() — метод для получения доступа к конкретной ячейке или диапазону.Рассмотрим рабочий код, к которому пришел автор в ходе обсуждения. Основная проблема заключалась в способе обращения к области ячейки.
В начале попытки код выглядел так:
Результат.Область("R" + Стр + "|C" + Колонка).ЦветТекста = WebЦвета.Черный;
Использование строковой адресации (формат "R1C1") часто приводит к ошибкам. Во-первых, синтаксис строки может зависеть от языка локализации платформы (R/C против R/C в русской раскладке, хотя обычно платформа понимает латиницу, разделители могут играть роль). Во-вторых, формирование строк в цикле — операция медленная. В-третьих, отладчик показывает, что свойство меняется, но визуально в интерфейсе изменений нет, если область определена неверно.
Наиболее надежный и быстрый способ получить доступ к ячейке — использовать перегрузку метода Область с числовыми параметрами: Область(Верх, Лево, Низ, Право). Для одной ячейки "Верх" равен "Низу", а "Лево" равно "Праву".
Посмотрим на исправленный и работающий алгоритм:
// Получаем границы таблицы
ВсегоКолонок = Результат.ШиринаТаблицы;
ВсегоСтрок = Результат.ВысотаТаблицы;
// Начинаем обход (например, с 6-й колонки)
Колонка = 6;
Пока Колонка <= ВсегоКолонок Цикл
Стр = 1;
Пока Стр <= ВсегоСтрок Цикл
// Получаем область конкретной ячейки по координатам
ОбластьЯчейка = Результат.Область(Стр, Колонка, Стр, Колонка);
// Проверяем условие. Важно: свойство Текст содержит строковое представление
Если ОбластьЯчейка.Текст = "⁃⁃⁃" Тогда
// Присваиваем цвет
ОбластьЯчейка.ЦветТекста = WebЦвета.Черный;
// Или, например, меняем фон
// ОбластьЯчейка.ЦветФона = WebЦвета.Желтый;
КонецЕсли;
Стр = Стр + 1;
КонецЦикла;
Колонка = Колонка + 1;
КонецЦикла;
Обратите внимание: использование свойства Текст для проверки условия может быть ненадежным, если в ячейке содержится число с форматированием. Например, число 0 может отображаться как пустая строка, если задан соответствующий формат. Если вы работаете с данными, надежнее проверять свойство Значение (если ячейка содержит значение) или Расшифровка.
В коде мы присваиваем свойству ЦветТекста значение. В 1С существует несколько способов задать цвет. Давайте разберем их, чтобы вы могли гибко настраивать визуальный стиль.
Это фиксированный набор цветов, который одинаково выглядит везде. Примеры: WebЦвета.Красный, WebЦвета.Лосось, WebЦвета.Черный. Это самый простой способ, если вам не нужно подстраиваться под тему оформления.
Это цвета, зависящие от текущей темы оформления интерфейса пользователя. Например, ЦветаСтиля.ЦветТекстаПоля или ЦветаСтиля.ЦветФонаОшибки. Использование стилей предпочтительно для создания "родного" интерфейса, который не режет глаз при смене тем (например, в такси или при темной теме).
ОбластьЯчейка.ЦветТекста = ЦветаСтиля.ЦветОтрицательногоЧисла;
Вы можете создать любой произвольный цвет, задав его компоненты RGB (Красный, Зеленый, Синий). Значения варьируются от 0 до 255.
ОбластьЯчейка.ЦветТекста = Новый Цвет(255, 0, 0); // Ярко-красный
Хотя рассмотренный выше метод работает, у него есть существенный недостаток, отмеченный опытными разработчиками. Циклический обход всех ячеек готового документа (особенно если в отчете тысячи строк) — это очень "дорогая" операция, которая может подвесить интерфейс.
Более правильный подход — определять цвет в момент формирования отчета, а не после него.
Обычно заполнение табличного документа происходит путем получения области из макета и вывода её в результирующую таблицу. Мы можем изменить свойства этой временной области перед тем, как добавить её в результат.
Рассмотрим пример правильной архитектуры вывода:
// 1. Получаем область из макета
ОбластьМакета = Макет.ПолучитьОбласть("Строка");
// 2. Заполняем параметры данными
ОбластьМакета.Параметры.Заполнить(ВыборкаДетальныеЗаписи);
// 3. Проверяем условие ДО вывода
Если ВыборкаДетальныеЗаписи.Статус = "Пустой" Тогда
// Меняем цвет только для текущей выводимой области
ОбластьМакета.Область("R1C5").ЦветТекста = WebЦвета.Красный;
Иначе
// Важно! Нужно вернуть цвет "по умолчанию", так как мы используем
// одну и ту же область макета многократно
ОбластьМакета.Область("R1C5").ЦветТекста = WebЦвета.Черный; // Или Авто
КонецЕсли;
// 4. Выводим уже раскрашенную область в итоговый документ
ТабДок.Вывести(ОбластьМакета);
В этом примере "R1C5" — это адрес ячейки внутри полученной области макета (относительная адресация), а не всего документа. Если у ячейки в макете задано имя (например, "ЯчейкаСумма"), лучше обращаться по имени: ОбластьМакета.Область("ЯчейкаСумма").
Область(Стр, Кол, Стр, Кол) с числовыми параметрами — это исключает ошибки синтаксиса адресации.ЦветТекста принимает значения типа Цвет. Используйте коллекции WebЦвета для фиксированных цветов или ЦветаСтиля для системных.Текст (то, что видит пользователь) и Значение (то, что хранится в ячейке). Для условий логичнее проверять значения.