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

Другое · 7 мин

Программное выделение строк табличной части в 1С

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

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

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

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

Отличие выделения строки от визуального оформления

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

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

Условное оформление как основной способ выделения

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

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

Когда проверять условие

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

Программное управление текущей строкой

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

Точные свойства и имена элементов зависят от конфигурации: в управляемых формах часто используется доступ к элементу формы через коллекцию Элементы, а в обычных формах — через ЭлементыФормы. Не используйте недокументированные свойства без проверки на копии.

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

Выделение нескольких строк и колонка выбора

Стандартная табличная часть не всегда поддерживает одновременное выделение нескольких строк обычным образом. Если пользователю нужно отметить группу записей для обработки, добавьте в табличную часть реквизит-флажок «Выбрать» и программно устанавливайте его в нужных строках.

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

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

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

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

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

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

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

Фон или шрифт меняются только для подходящих строк

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

Все строки окрашены или цвет не исчезает

Текущая строка после программного перехода
Норма

Фокус установлен на нужную запись

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

Фокус не перемещается или сбрасывается при вводе

Поведение в целевом клиенте
Норма

Одинаково в тонком, толстом или веб-клиенте

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

Отличия между клиентами без дополнительной настройки

Частые ошибки и безопасность

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

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

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

Альтернативы и когда обращаться к разработчику

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

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

Итог

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

Разделяйте программное управление текущей строкой и визуальное оформление; используйте условное оформление, тестируйте на копии и проверяйте в целевом клиенте.

Можно ли выделить строку табличной части только кодом без конструктора?

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

Отличается ли выделение в обычной и управляемой формах?

Да. В обычных формах используется объектная модель ЭлементыФормы, в управляемых — коллекция Элементы формы и свойства табличного поля. Имена свойств и способы доступа к строкам могут различаться.

Сохранится ли цвет строки после закрытия формы?

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

Что делать, если цвет не применяется в веб-клиенте?

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