При использовании объекта ПостроительОтчета для вывода табличного документа из таблицы значений многие разработчики сталкиваются с тем, что в итоговом документе слева всегда появляется «лишняя» пустая колонка. Разберемся, почему это происходит и как программно избавиться от этого элемента.
Важно понимать природу работы ПостроительОтчета. Этот объект при выводе данных в ТабличныйДокумент по умолчанию резервирует первую колонку под служебные нужды. Даже если в вашем отчете нет иерархии, группировок или значков для сворачивания строк, ПостроительОтчета все равно закладывает отступ, ожидая, что эти элементы могут быть использованы. Это технический отступ, который система считает обязательной частью макета.
Многие пытаются удалить колонку, обращаясь к ней по имени, например, ТабДок.Область(\"C1\"). Однако, в силу сложной структуры макета, создаваемого Построителем, такой метод часто не срабатывает. Чтобы гарантированно удалить колонку, необходимо указать физические координаты области, охватывающей все строки таблицы.
Рассмотрим правильный подход к решению:
ВысотаТаблицы.Вот пример кода, который корректно справляется с задачей:
// Определяем область первой колонки по всей высоте таблицы
ОбластьУдаления = ТабДок.Область(1, 1, ТабДок.ВысотаТаблицы, 1);
// Удаляем область, сдвигая содержимое слева направо
ТабДок.УдалитьОбласть(ОбластьУдаления, ТипСмещенияТабличногоДокумента.ПоГоризонтали);
Обратите внимание: при использовании метода УдалитьОбласть с указанием координат через конструктор Область(Верх, Лево, Низ, Право), система четко понимает границы блока, что позволяет избежать ошибок форматирования.
Иногда физическое удаление области может нарушить структуру макета или привести к нежелательному смещению других элементов. В таких ситуациях профессионалы рекомендуют использовать более щадящие методы визуального скрытия колонки.
Мы можем просто скрыть колонку, сохранив её в структуре документа. Это полезно, если вам может потребоваться доступ к данным этой колонки в дальнейшем (например, при программном анализе ячеек).
// Скрываем первую колонку
ТабДок.Область(, 1, , 1).Видимость = Ложь;
Еще один элегантный способ — установить ширину колонки равной нулю. Визуально это даст тот же эффект, что и удаление, но структура документа останется неизменной.
// Схлопываем первую колонку
ТабДок.Область(, 1, , 1).ШиринаКолонки = 0;
Если вы хотите избежать редактирования ТабличныйДокумент после вывода, попробуйте манипулировать макетом самого ПостроительОтчета. Вы можете сгенерировать макет программно, очистить его настройки или модифицировать параметры областей еще до того, как данные попадут в итоговый отчет.
Важное примечание: при работе с ПостроительОтчета всегда помните о том, что он создает «умные» области. Если ваш отчет сложный и содержит много итогов, лучше использовать скрытие (Видимость = Ложь), чем удаление, так как удаление колонок может привести к ошибкам в формулах или именованных областях, которые Построитель мог создать автоматически.
Мы проанализировали основные способы решения задачи. Выбор метода — удаление или скрытие — зависит от специфики вашего отчета. Для простых отчетов без иерархии отлично подходит удаление через явное указание координат, а для сложных отчетов с итогами безопаснее использовать скрытие первой колонки.