Обход табличной части формы 1С: от реквизитов до выделенных строк

Разработка пользовательских интерфейсов в платформе 1С:Предприятие 8 часто требует тонкой настройки поведения табличных частей форм. Программисты сталкиваются с необходимостью динамически изменять свойства строк, проверять заполненность данных или выполнять расчеты «на лету» при перемещении курсора.

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

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

Архитектура объектов табличной части в форме

Прежде чем приступать к написанию кода, необходимо четко представлять, с какими объектами мы взаимодействуем. Табличная часть на форме — это не просто массив данных, а сложный объект ТабличноеПолеКомпоновкиДанных или стандартный элемент формы, привязанный к ТабличномуПолю.

Основной объект, с которым работает разработчик при обходе, называется ЭлементыФормы. Внутри него табличная часть представлена как коллекция строк. Важно различать данные таблицы (объект данных) и визуальное представление (элемент формы).

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

Каждая строка в цикле представляет собой объект СтрокаТабличнойЧастиФормы. Через этот объект можно получить доступ к любым реквизитам строки, изменить их видимость или доступность для редактирования.

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

Базовый алгоритм перебора всех строк

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

Рассмотрим пример кода, который проходит по всем строкам табличной части Товары и проверяет количество. Если количество меньше единицы, строка помечается специальным цветом или флагом.

Для каждого СтрокаТаблицы Из ЭлементыФормы.Товары.Строки Цикл
Если СтрокаТаблицы.Количество < 1 Тогда
СтрокаТаблицы.ЦветФона =_web.Красный;
Сообщить("Ошибка в строке:" + СтрокаТаблицы.НомерСтроки);
КонецЕсли;
КонецЦикла;

В данном примере мы обращаемся к ЭлементамФормы, а не к объекту данных документа. Это позволяет мгновенно отразить изменения в интерфейсе пользователя без дополнительной команды ОбновитьОкно.

Частой ошибкой является попытка изменения состава коллекции (удаление или добавление строк) непосредственно внутри цикла перебора. Это приводит к ошибке выполнения «Изменение коллекции во время перебора».

• 🚀 Используйте временные массивы для сбора строк на удаление, если планируете чистку таблицы.
• 🛡️ Всегда проверяйте строку на пустоту перед обращением к её реквизитам во избежание ошибок_null.
• 📉 Оптимизируйте циклы, прерывая их досрочно через оператор Прервать, если цель достигнута.

Работа с выделенными строками и текущей позицией

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

Свойство ТекущиеДанные возвращает объект текущей активной строки, на которой стоит курсор. Это наиболее быстрый способ получить доступ к данным без организации цикла.

Если же пользователю разрешено мультиселект (выделение нескольких строк через Ctrl или Shift), необходимо использовать свойство ВыделенныеСтроки. Оно возвращает коллекцию индексов или сами объекты строк в зависимости от версии платформы и настроек элемента.

Свойство элемента	Тип возвращаемого значения	Описание назначения
ТекущиеДанные	СтрокаТабличнойЧастиФормы	Единственная активная строка под курсором
ВыделенныеСтроки	Массив или Коллекция	Набор строк, выделенных пользователем
ИндексТекущейСтроки	Число	Порядковый номер строки в отображении
КоличествоСтрок	Число	Общее число видимых строк в таблице

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

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

Особенность работы с иерархическими таблицами

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

Обход с использованием индексов и рекурсии

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

Использование числового индекса позволяет обращаться к элементу коллекции как к массиву: ЭлементыФормы.Товары.Строки[Индекс]. Это дает гибкость, но требует осторожности с границами массива.

Для Индекс = 0 По ЭлементыФормы.Товары.Строки.Количество - 1 Цикл
ТекущаяСтрока = ЭлементыФормы.Товары.Строки[Индекс];
// Логика обработки с доступом к соседям
КонецЦикла;

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

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

• 🔍 Индексация начинается с нуля, в отличие от нумерации строк в базе данных, которая часто начинается с единицы.
• 🔄 Рекурсивный обход требует контроля глубины вложенности во избежание переполнения стека.
• ⚡ Доступ по индексу быстрее, чем поиск строки по ключу в больших коллекциях.

Оптимизация производительности при массовых операциях

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

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

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

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

⚠️ Внимание: В тонком клиенте любые длительные операции в основном потоке блокируют интерфейс. Для обработки больших объемов данных используйте асинхронные вызовы или фоновые задания.

Типичные ошибки и способы их предотвращения

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

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

Всегда используйте функцию ЗначениеЗаполнено или проверку на ТипЗнч перед выполнением действий над данными строки. Это сделает ваш код устойчивым к некорректному вводу данных пользователем.

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

Для отладки сложных циклов используйте точки останова и окно «Переменные». Просмотр содержимого коллекции Строки в реальном времени помогает понять, почему цикл пропускает элементы или выполняется лишнее количество раз.

Секрет быстрой отладки

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

Можно ли добавлять строки в таблицу во время её обхода циклом?

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

Как получить доступ к строке, если известен только её уникальный идентификатор (Ссылка)?

Используйте метод НайтиПоИдентификатору(Идентификатор) у коллекции строк элемента формы. Это эффективнее, чем перебирать все строки в цикле с условием сравнения.

Почему свойство ВыделенныеСтроки возвращает пустой массив, хотя строки выделены?

Проверьте свойство элемента формы «Многострочное выделение». Если оно отключено, свойство ВыделенныеСтроки работать не будет, следует использовать ТекущиеДанные.

Влияет ли отбор на форме на результат обхода через ЭлементыФормы.Строки?

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

Как обойти только видимые колонки в строке?

Используйте коллекцию Колонки элемента таблицы. Свойство Видимость у колонки подскажет, нужно ли её обрабатывать. Это актуально для динамических списков и отчетов.