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