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