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