Программное создание страниц на форме в 1С Предприятие

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

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

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

Архитектура управляемых форм и элементы TabPages

Прежде чем писать код, необходимо разобраться в структуре управляемой формы. Основным контейнером для вкладок служит элемент типа Страницы (аналог Pages или TabControl в других средах). Каждая вкладка внутри него представляет собой объект метаданных, имеющий уникальное имя, заголовок и коллекцию собственных реквизитов.

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

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

⚠️ Внимание: Изменение структуры формы (добавление/удаление страниц) возможно только в серверном контексте. Клиентский код не имеет прав на модификацию коллекции элементов формы напрямую.

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

Алгоритм добавления страницы в процедуре ПриСозданииНаСервере

Самый распространенный сценарий — добавление вкладок при инициализации формы. Для этого используется процедура ПриСозданииНаСервере. В этом обработчике у разработчика есть полный доступ к объекту Форма и всем его элементам. Здесь мы можем безопасно манипулировать коллекцией Страницы нужного элемента управления.

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

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

Рассмотрим пример кода, который создает новую страницу в группе с именем ГруппаВкладок:

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

// Получаем ссылку на элемент формы "ГруппаВкладок"
ЭлементВкладки = Элементы.ГруппаВкладок;

// Создаем новую страницу
НоваяСтраница = ЭлементВкладки.Страницы.Добавить(Тип("СтраницаФормы"));

// Настраиваем свойства
НоваяСтраница.Имя = "ДополнительнаяИнформация";
НоваяСтраница.Заголовок = "Детализация";
НоваяСтраница.Видимость = Истина;

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

Обратите внимание, что свойство Видимость управляет отображением страницы для пользователя. Если установить значение Ложь, вкладка будет существовать в структуре формы, но не отобразится в интерфейсе. Это удобно для реализации логики, зависящей от прав доступа (РПД).

Наполнение страницы реквизитами и группировка элементов

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

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

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

Пример добавления поля ввода и текстовой метки на newly created страницу:

    // Создаем поле ввода
ПолеВвода = НоваяСтраница.Реквизиты.Добавить(Тип("ПолеФормы"));
ПолеВвода.Имя = "ПолеКомментарий";
ПолеВвода.Вид = ВидПоляФормы.ПолеВвода;
ПолеВвода.Данные = "КомментарийДинамический";
ПолеВвода.Заголовок = "Комментарий:";

// Создаем декорацию (надпись)
Декорация = НоваяСтраница.Реквизиты.Добавить(Тип("ДекорацияФормы"));
Декорация.Имя = "НадписьПодсказка";
Декорация.Вид = ВидДекорацииФормы.Надпись;
Декорация.Заголовок = "Заполните поле выше";

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

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

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

Для доступа к созданной программно странице из других процедур модуля необходимо обращаться к ней по имени через коллекцию родителя. Например, Элементы.ГруппаВкладок.Страницы.ДополнительнаяИнформация. Если имя страницы хранится в переменной, можно использовать динамическое обращение через квадратные скобки: Элементы.ГруппаВкладок.Страницы[ИмяСтраницы].

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

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

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

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

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

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

Как связать событие с процедурой?

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

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

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

⚠️ Внимание: Интерфейс платформы 1С и доступные свойства элементов могут отличаться в зависимости от версии платформы и режима совместимости. Всегда проверяйте актуальность свойств в Синтакс-помощнике вашей версии 1С.

Очистка ресурсов и удаление созданных страниц

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

Для удаления страницы используется метод Удалить() коллекции Страницы. Можно удалить страницу по индексу или по ссылке на сам объект. После удаления все вложенные реквизиты также освобождаются. Однако, если вы создавали реквизиты формы (данные) отдельно от визуальных элементов, их нужно удалять из коллекции Реквизиты формы вручную.

Неправильное управление жизненным циклом динамических элементов может привести к утечкам памяти или ошибкам "Элемент не найден" при попытке обращения к уже удаленному объекту. Всегда проверяйте существование элемента перед операцией удаления с помощью метода Найти().

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

Можно ли добавить страницу на форму из клиентского кода?

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

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

Для этого после создания страницы нужно присвоить свойство ТекущаяСтраница родительского элемента (группы вкладок) ссылку на newly created объект страницы. Например: Элементы.ГруппаВкладок.ТекущаяСтраница = НоваяСтраница.

Что делать, если имя страницы конфликтует с существующим?

Перед добавлением проверяйте коллекцию страниц методом Найти(). Если элемент с таким именем уже существует, либо используйте другое имя (добавьте суффикс или GUID), либо удалите существующий элемент перед созданием нового.

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

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