К статье
Практический материал

Другое · 7 мин

Как программно выделить строки в таблице 1С

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

В 1С выделение строк чаще всего означает изменение фона или шрифта строк в табличном поле, табличной части или списке значений по заданному условию. Это отличается от обычного выделения текущей строки пользователем: программная подсветка остаётся видимой, пока условие истинно, даже если пользователь переместит фокус на другую строку.

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

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

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

Когда программная подсветка строк уместна

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

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

Примеры ситуаций для подсветки

  • строки с истёкшим сроком исполнения;
  • позиции с остатком ниже допустимого;
  • документы на согласовании или с ограниченным доступом;
  • повторяющиеся значения в реквизите, где ожидается уникальность.

Как работает условное оформление

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

1c
Элемент = Элементы.МояТаблица;
Оформление = Элемент.УсловноеОформление.Элементы.Добавить();
Оформление.Использование = Истина;
Оформление.Поле = "Статус";
Оформление.Условие = "Значение = 'Требует внимания'";
Оформление.Оформление.ЦветФона = WebЦвета.Желтый;

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

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

Порядок действий
  1. 1
    Откройте модуль формы и определите элемент для подсветки
  2. 2
    Добавьте элемент условного оформления программно или через свойства элемента
  3. 3
    Укажите поле, условие и цвет фона или шрифта
  4. 4
    Проверьте поведение при открытии, вводе данных и сортировке
  5. 5
    Зафиксируйте результат на копии базы перед переносом в рабочую

Программная настройка в модуле формы

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

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

Типичные ошибки
01
Попытка программно установить текущую строку вместо постоянной подсветки — эффект пропадает при перерисовке таблицы
02
Изменение конфигурации без резервной копии и проверки на копии — риск потери изменений при обновлении

Отличие выделения строки от подсветки

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

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

Контрольные точки

Как проверить результат

Цвет строки при выполнении условия
Норма

Строка окрашена сразу и при изменении данных

Тревожный признак

Цвет отсутствует или появляется не у всех подходящих строк

Поведение после сортировки и переоткрытия
Норма

Подсветка восстанавливается по условию

Тревожный признак

Цвет сбрасывается или остаётся на неверной строке

Работа с новыми записями
Норма

Новая строка окрашивается при заполнении реквизита

Тревожный признак

Подсветка не применяется к только что добавленным строкам

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

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

Ограничения касаются производительности и поддерживаемых элементов. Слишком много правил или сложные выражения на больших таблицах могут замедлять открытие и прокрутку. Некоторые элементы обычных форм могут не поддерживать программное условное оформление в том же объёме, что управляемые формы.

Частые ошибки и безопасные границы

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

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

Итог

Что важно запомнить

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

Можно ли выделить строку цветом без условного оформления?

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

Почему подсветка исчезает после сортировки или переоткрытия?

Сортировка и повторное открытие приводят к перерисовке таблицы. Если цвет задавался через временное выделение или текущую строку, он сбрасывается. Условное оформление обычно восстанавливает цвет автоматически, если условие остаётся истинным.

Различается ли подсветка строки и выделение текущей строки?

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

Безопасно ли добавлять правила подсветки в рабочую базу?

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