Программное добавление табличной части на форму в 1С

Разработка пользовательского интерфейса в платформе 1С:Предприятие 8 часто выходит за рамки стандартных возможностей конструктора форм. В ситуациях, когда требуется динамическое отображение данных или создание универсальных инструментов ввода, единственным верным решением становится манипуляция элементами формы на лету. Программное создание табличной части позволяет гибко управлять структурой интерфейса в зависимости от контекста работы пользователя.

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

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

Подготовка реквизитов формы и типа данных

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

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

Код инициализации выглядит следующим образом:

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)

// Создаем новый реквизит формы
НовыйРеквизит = Новый РеквизитФормы("МояТаблица", ТипРеквизитаФормы("ТаблицаЗначений"), "Значение");

// Описываем структуру колонок
ОписаниеКолонок = Новый ОписаниеТипов("Строка, Число, Дата");

// Добавляем колонки в таблицу значений
ТабЗнач = Новый ТаблицаЗначений;
ТабЗнач.Колонки.Добавить("Код", ОписаниеКолонок);
ТабЗнач.Колонки.Добавить("Наименование", ОписаниеКолонок);
ТабЗнач.Колонки.Добавить("Сумма", ОписаниеКолонок);

// Присваиваем значение реквизиту
НовыйРеквизит.Значение = ТабЗнач;

// Добавляем реквизит на форму
ЭтотОбъект.Реквизиты.Добавить(НовыйРеквизит);

КонецПроцедуры

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

Создание визуального элемента ТабличноеПоле

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

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

⚠️ Внимание: При создании элемента в клиентском контексте убедитесь, что имя элемента уникально в пределах формы. Попытка добавить элемент с дублирующимся именем вызовет исключение и прервет работу формы.

Рассмотрим пример создания элемента управления:

Процедура СоздатьТаблицуНаФорме()

// Имя реквизита, к которому привязываемся
ИмяРеквизита = "МояТаблица";

// Создаем элемент типа ТабличноеПоле
ТабличноеПоле = Элементы.Добавить("МояТаблицаПоле", Тип("ТабличноеПолеФормы"), ИмяРеквизита);

// Настраиваем базовые свойства
ТабличноеПоле.Видимость = Истина;
ТабличноеПоле.ТолькоПросмотр = Ложь;
ТабличноеПоле.ВысотаВСтроках = 10;

// Устанавливаем заголовок, если элемент не в группе
ТабличноеПоле.Заголовок = "Динамические данные";

КонецПроцедуры

В данном коде мы явно указываем тип элемента через функцию Тип(), что является хорошей практикой для читаемости кода. Свойство ПутьКДанным (третий параметр метода Добавить) связывает визуальную оболочку с данными.

Настройка колонок и заголовков таблицы

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

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

• 📊 Идентификатор — имя поля в таблице значений (например, "Код").
• 🏷️ Заголовок — текст, отображаемый в шапке таблицы (например, "Артикул товара").
• 📏 Ширина — фиксированное значение или режим автоподбора.

Пример настройки колонок:

Процедура НастроитьКолонки()

ЭлементТаблицы = Элементы.МояТаблицаПоле;

// Очищаем авто-колонки, если они есть
ЭлементТаблицы.Колонки.Очистить();

// Добавляем первую колонку
Колонка1 = ЭлементТаблицы.Колонки.Добавить("Код");
Колонка1.Заголовок = "Код номенклатуры";
Колонка1.Ширина = 5;

// Добавляем вторую колонку
Колонка2 = ЭлементТаблицы.Колонки.Добавить("Наименование");
Колонка2.Заголовок = "Наименование товара";
Колонка2.Ширина = 20;

// Добавляем третью колонку с числовым форматом
Колонка3 = ЭлементТаблицы.Колонки.Добавить("Сумма");
Колонка3.Заголовок = "Сумма, руб.";
Колонка3.ГоризонтальноеПоложение = ГоризонтальноеПоложениеТекстаЯчейкиТабличногоДокумента.Право;

КонецПроцедуры

Как скрыть колонку программно?

Чтобы скрыть колонку, но не удалять её из структуры, установите свойство Видимость у объекта колонки в значение Ложь. Это полезно при динамическом изменении состава полей.

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

Динамическое управление видимостью и доступностью

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

Управление видимостью осуществляется через свойство Видимость элемента формы. Это булево значение, которое можно менять как на клиенте, так и на сервере (с последующим обновлением формы). Изменение свойства ТолькоПросмотр блокирует возможность редактирования ячеек.

Свойство	Тип значения	Описание влияния на таблицу
Видимость	Булево	Полностью скрывает таблицу с экрана, освобождая место для других элементов.
ТолькоПросмотр	Булево	Запрещает ввод данных, выделение ячеек и вызов контекстного меню.
РежимВыбора	РежимВыбораТабличногоПоля	Определяет, можно ли выделять строки, ячейки или ничего не выделять.
РастягиватьПоГоризонтали	Булево	Заставляет таблицу занимать всю доступную ширину родительской группы.

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

⚠️ Внимание: Изменение структуры таблицы (добавление/удаление колонок) на клиенте возможно только если таблица не находится в режиме редактирования ячейки. Иначе возникнет ошибка блокировки.

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

Обработка событий и взаимодействие с пользователем

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

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

• 🖱️ ПриНачалеРедактированияВнутри — срабатывает при клике на ячейку. Позволяет подставить значение по умолчанию.
• 💾 ПриЗаписиНаСервере — вызывается при сохранении строки. Идеально для проверок и расчетов.
• 🔄 ПриИзменении — реакция на смену данных в конкретной колонке.

Пример обработчика изменения значения в колонке "Сумма":

&НаКлиенте
Процедура МояТаблицаПолеПриИзменении(Элемент)

// Получаем текущую строку
ТекущаяСтрока = Элементы.МояТаблицаПоле.ТекущиеДанные;

Если ТекущаяСтрока = Неопределено Тогда
Возврат;
КонецЕсли;

// Пример логики: если сумма больше 1000, подсветить строку (через условное оформление)
// Или вызвать пересчет итогов
ПересчитатьИтоги();

КонецПроцедуры

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

Частые ошибки и оптимизация производительности

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

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

⚠️ Внимание: Интерфейс платформы 1С и объектная модель могут незначительно меняться в новых версиях. Всегда сверяйте синтаксис методов в справке по вашей конкретной версии платформы (8.3.20+).

Оптимизация заключается в минимизации перерисовки формы. Если вы меняете несколько свойств таблицы, старайтесь делать это в одном блоке кода. Избегайте частого обновления больших таблиц на клиенте — для объемов более 10-20 тысяч строк лучше использовать виртуальные таблицы или paginate (постраничный вывод).

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

Вопросы и ответы (FAQ)

Можно ли добавить табличную часть внутрь другой группы программно?

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

Как программно удалить созданную таблицу с формы?

Для удаления элемента используйте метод Элементы.Удалить("ИмяЭлемента"). Также рекомендуется очистить соответствующий реквизит из коллекции Реквизиты, если он больше не нужен, чтобы освободить память.

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

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

Можно ли изменить тип колонки уже созданной таблицы?

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

Как добавить кнопку удаления строки в динамическую таблицу?

Создайте команду формы (тип КомандаФормы) и добавьте элемент типа КнопкаКоманднойПанели в командную панель вашей таблицы. В обработчике команды получайте текущую строку таблицы и удаляйте её из массива данных.