Другое · 9 мин
Программное выделение строки в табличной части 1С
Программное выделение строки в табличной части 1C: текущая строка, выбор и условное оформление, пошаговые действия, проверка и частые ошибки.
Выделение строки в табличной части 1С может означать две разные задачи: программное выделение текущей или отмеченной строки и визуальное выделение фона или шрифта. Первое влияет на то, с какой записью будет работать дальнейший код, второе только меняет отображение для пользователя. Перед написанием кода нужно определить, какой результат нужен в конкретной форме документа, справочника или обработки.
Реализация зависит от типа формы, конфигурации и версии платформы, поэтому точные имена свойств и методов лучше уточнять в конфигураторе для своей базы. В управляемых формах работа с табличной частью обычно ведётся через элементы формы и модуль формы, а в обычных формах порядок может отличаться. Независимо от варианта изменения в табличной части лучше проводить на копии информационной базы, особенно если форма участвует в проведении документах или закрытии периода.
Целью программного выделения может быть установка текущей строки перед редактированием, удалением или заполнением связанных реквизитов. Также выделение используется для привлечения внимания к строкам, не прошедшим проверку, или к записям, требующим действий пользователя. В обоих случаях важно отделить логику выбора от оформления и проверять, что строка действительно изменила состояние после выполнения кода.
H2: Что понимать под выделением строки табличной части
Программное выделение строки чаще всего означает изменение свойства текущей строки элемента табличной части. После такого изменения последующие действия формы, например чтение реквизитов строки или вызов команды, будут относиться к выбранной записи. Это полезно, когда нужно автоматически перефокусировать пользователя на только что добавленную или изменённую строку.
Визуальное выделение не меняет логику работы, но меняет цвет фона, шрифта или стиль ячейки. Оно реализуется через условное оформление, которое срабатывает по условию на значения реквизитов строки. Такой подход подходит для подсветки неполных, заблокированных или требующих проверки записей без изменения текущего выбора.
Важно не путать табличную часть формы с отдельной таблицей значений. У таблицы значений нет собственной визуальной выделенной строки в интерфейсе, поэтому выделение там реализуется дополнительным реквизитом-маркером или отдельным отчётом. В форме табличная часть имеет элементы управления, через которые можно управлять текущей и выделенными строками.
Как выбрать действие
H2: Где и как задаётся текущая строка
В модуле формы обращение к табличной части обычно выполняется через коллекцию элементов формы, например по имени поля табличной части. В обработчиках событий, таких как открытие формы, изменение реквизита или нажатие кнопки, можно присваивать текущую строку нужной записи табличной части. После этого форма будет отображать выбранную строку как активную.
Ход действий зависит от того, строка уже существует в табличной части или только создаётся. Для существующей строки достаточно сослаться на неё по ссылке или по порядковому номеру, если конфигурация поддерживает такой доступ. Для только что добавленной строки текущую строку устанавливают после завершения добавления, чтобы пользователь сразу увидел новую запись.
- 1Определите элемент формы, представляющий табличную часть
- 2Выберите нужную строку по условию или по ссылке
- 3Назначьте строку текущей или добавьте её в выделенные
- 4Проверьте изменение выделения на форме
Некоторые конфигурации предоставляют коллекцию выделенных строк, в которую можно добавить несколько записей одновременно. Это уместно для массовых операций, например удаления или переноса группы строк. Если нужно выделить только одну строку, предварительно очищают текущее выделение, чтобы не остались лишние отметки.
H2: Условное оформление как визуальное выделение
Условное оформление позволяет задать правило, при выполнении которого строка или ячейка меняет цвет, шрифт или стиль. Условие может зависеть от значения любого реквизита строки: статуса, суммы, даты, признака ошибки. Такое выделение работает автоматически при открытии формы и при изменении данных, без дополнительного кода в каждом обработчике.
Настройка ведётся в свойствах элемента табличной части или через отдельное правило условного оформления, в зависимости от конфигурации. Правило должно быть проверяемым и не зацикливаться: изменение оформления не должно вызывать повторное пересчитывание того же условия в бесконечном цикле.
Если выделение нужно сохранить после закрытия формы, одно лишь программное присваивание текущей строки обычно недостаточно. Состояние выделения фиксируют в отдельном реквизите формы, регистре сведений или справочнике, а при открытии формы восстанавливают по сохранённому значению. Иначе после повторного открытия выделение сбросится.
H2: Проверка результата и границы безопасной работы
После установки текущей строки рекомендуется проверить, что свойство текущей строки действительно указывает на ожидаемую запись. Можно сравнить реквизит строки, её номер или уникальный идентификатор с заданным условием. Если строка не найдена, код должен обрабатывать эту ситуацию, а не молча завершаться.
Изменение выделения внутри событий табличной части может привести к повторному вызову того же события или к конфликту с несохранёнными данными. Особенно осторожно нужно работать в обработчиках проведения, записи и закрытия документа, где неправильное переключение строки может повлиять на проведенные данные или привести к ошибкам сохранения.
Самостоятельная правка кода допустима для обычных форм и некритичных справочников, если изменение ограничивается установкой текущей строки или простым условным оформлением. Если затрагиваются механизмы проведения, закрытия периода, обмена данными или распределённых информационных баз, работу лучше выполнять с привлечением разработчика или ответственного за конфигурацию.
H2: Частые ошибки и способы их избежать
Одна из частых ошибок — попытка выделить строку, которая ещё не добавлена в табличную часть или уже удалена. Код может завершаться ошибкой или выбирать не ту запись. Перед присваиванием текущей строки проверяйте существование строки и соответствие условию отбора.
Другая ошибка — смешение программного выделения и условного оформления. Разработчик подсвечивает строку цветом, а затем ожидает, что код будет работать именно с этой подсвеченной строкой. На самом деле визуальное выделение не меняет текущую строку, поэтому логика может обрабатывать другую запись.
Также не стоит устанавливать текущую строку при каждом незначительном изменении формы, если это вызывает постоянное перемещение фокуса. Пользователю становится неудобно работать, а форма может лишний раз перерисовываться. Выделение должно быть обоснованным и применяться только там, где оно действительно упрощает ввод или проверку данных.
Как проверить результат
Указывает на ожидаемую запись табличной части
Указывает на другую строку или не меняется
Цвет меняется только при выполнении условия
Подсвечиваются все строки или условие не срабатывает
H2: Альтернативы и контрольные точки
Если программное выделение строки слишком сложно реализовать стабильно, можно использовать дополнительный реквизит-маркер в строке табличной части. Пользователь ставит флажок нужным записям, а код обрабатывает все отмеченные строки. Это надёжнее, чем полагаться на текущее выделение интерфейса, которое может сброситься при перерисовке формы.
Для проверки результата используйте отображение формы: текущая строка должна выделяться стандартным образом, а условное оформление должно менять цвет только при выполнении заданного условия. Если после закрытия и открытия формы выделение пропадает, это нормально для временного выбора, но сигнализирует о необходимости сохранения состояния в реквизите.
Что важно запомнить
Программное выделение строки и визуальное подсвечивание — разные задачи; точные свойства уточняются в конфигураторе, а изменения лучше проверять на копии базы.
Нужно ли выделять строку в каждом обработчике изменения табличной части?
Не обязательно. Постоянное программное выделение при каждом изменении может сбивать пользователя с толку и вызывать лишнюю перерисовку формы. Лучше устанавливать текущую строку только в конкретных ситуациях, например после добавления записи или перед важной командой.
Отличается ли выделение строки в управляемых и обычных формах?
Да, порядок работы с табличной частью может различаться в зависимости от типа формы и конфигурации. В управляемых формах управление чаще ведётся через элементы формы, а в обычных — по-своему. Имена свойств и способы доступа уточняются в конфигураторе для конкретной базы.
Может ли цвет строки заменить программное выделение?
Нет. Условное оформление меняет только внешний вид, а код по-прежнему работает с той строкой, которая установлена текущей. Если нужно обработать подсвеченную строку, отдельно устанавливайте текущую строку или используйте реквизит-маркер.
Что делать, если выделение пропадает после закрытия формы?
Это обычное поведение для временного интерфейсного выбора. Если состояние нужно восстановить при следующем открытии, сохраните выбранную строку в реквизите формы, регистре сведений или другом постоянном хранилище и восстанавливайте его при открытии формы.