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

Другое · 9 мин

Позиционирование на строке табличной части в 1С: пошаговое руководство

Практическая инструкция по установке текущей строки табличной части в 1С:Предприятии: способы, условия, проверка результата и типичные ошибки.

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

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

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

1. Что понимают под текущей строкой табличной части

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

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

Когда позиционирование обязательно

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

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

2. Основные способы установить текущую строку

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

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

Через свойство формы и табличное поле

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

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

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

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

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

3. Порядок действий при программном позиционировании

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

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

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

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

4. Как проверить, что строка действительно выбрана

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

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

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

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

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

Визуальное выделение строки
Норма

Выделена ожидаемая запись

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

Выделена другая строка или выделение отсутствует

Значения реквизитов текущей строки
Норма

Совпадают с целевой записью

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

Данные относятся к другой строке или пустые.

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

Операция завершена успешно

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

Ошибка выполнения или работа с неверной записью

5. Ограничения и риски при работе с табличной частью

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

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

Не стоит вручную корректировать внутренние идентификаторы строк табличной части. Это может нарушить целостность документа и привести к ошибкам при проведении или сохранении.

6. Типичные ошибки и как их избежать

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

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

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

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

7. Сравнение подходов к позиционированию

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

Сравнение вариантов

Через свойства табличного поля

Подходит для типовых форм, требует минимума кода, зависит от вида представления таблицы

Через программную работу с данными

Даёт больше контроля, но требует учёта сортировки и состояния редактирования

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

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

Итог

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

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

Часто задаваемые вопросы

Нужно ли всегда программно устанавливать текущую строку табличной части?

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

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

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

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

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

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

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

Отличается ли позиционирование в обычном и управляемом приложении?

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