Как добавить элемент формы в 1С

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

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

Где находятся элементы формы и как открыть редактор

Форма хранится внутри объекта конфигурации: у справочника, документа, отчёта или обработки. Чтобы открыть её, найдите объект в дереве конфигурации, раскройте ветку «Формы» и дважды щёлкните по нужной форме. Если формы нет — платформа использует автоматически генерируемую, и её нужно создать: правой кнопкой по объекту → «Добавить» → «Форма», затем выбрать тип («Форма объекта», «Форма списка» и т.д.).

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

Как добавить элемент визуально в конфигураторе

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

Второй вариант — контекстное меню в дереве элементов. Щёлкните правой кнопкой по группе, в которую хотите поместить новый элемент, выберите «Добавить» и укажите тип: поле, кнопка, декорация, группа, таблица. После добавления элемент появится в конце списка родителя — перетащите его в нужную позицию, так как порядок в дереве определяет порядок на экране.

1. 1
   Откройте форму объекта в конфигураторе и перейдите на вкладку редактора формы
2. 2
   В дереве элементов выделите группу-родителя, куда попадёт новый элемент
3. 3
   Правой кнопкой выберите «Добавить» и укажите тип элемента либо перетащите реквизит из списка реквизитов
4. 4
   Задайте имя элемента, заголовок и при необходимости свойство «ПутьКДанным»
5. 5
   Сохраните конфигурацию и проверьте вид формы в режиме предприятия

Настройка свойств нового элемента

После добавления откройте палитру свойств (правый клик по элементу → «Свойства»). Минимальный набор: «Имя» — уникальный идентификатор для обращения из кода, «Заголовок» — текст, который увидит пользователь, «ПутьКДанным» — связь с реквизитом формы. Без корректного пути к данным поле отобразится, но ничего не покажет и не сохранит.

Для полей ввода полезны свойства «КнопкаСпискаВыбора», «ПодсказкаВвода» и «АвтоОтметкаНезаполненного». Для кнопок ключевое свойство — «ИмяКоманды»: кнопка не работает сама по себе, она вызывает команду формы, которую нужно создать на закладке «Команды» и описать обработчик в модуле. Декорации (надписи и картинки) не требуют реквизита, если отображают статичный текст — он задаётся в свойстве «Заголовок».

Как добавить элемент программно

Программное добавление нужно, когда состав элементов зависит от условий: роли пользователя, вида документа, настроек. В управляемой форме элементы создают в обработчике «ПриСозданииНаСервере» — это единственный безопасный момент, когда структура формы ещё формируется. Сначала добавляют реквизит через метод «ИзменитьРеквизиты», затем элемент через «Элементы.Добавить».

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    ДобавляемыеРеквизиты = Новый Массив;
    НовыйРеквизит = Новый РеквизитФормы("КомментарийДоп", Новый ОписаниеТипов("Строка", , Новый КвалификаторыСтроки(200)));
    ДобавляемыеРеквизиты.Добавить(НовыйРеквизит);
    ИзменитьРеквизиты(ДобавляемыеРеквизиты);
    
    НовоеПоле = Элементы.Добавить("КомментарийДоп", Тип("ПолеФормы"), Элементы.ГруппаДополнительно);
    НовоеПоле.Вид = ВидПоляФормы.ПолеВвода;
    НовоеПоле.ПутьКДанным = "КомментарийДоп";
    НовоеПоле.Заголовок = "Доп. комментарий";
КонецПроцедуры

Третий параметр метода «Добавить» — родительская группа. Если её не указать, элемент попадёт в корень формы и может оказаться в неожиданном месте. После создания элемента можно менять его свойства так же, как в конфигураторе: видимость, доступность, заголовок, цвет.

Учтите ограничение: «ИзменитьРеквизиты» вызывается только на сервере и только до того, как форма показана пользователю. Изменить состав реквизитов «на лету» по кнопке нельзя — зато можно заранее создать все нужные элементы и управлять их видимостью через свойство «Видимость» без пересоздания формы.

Добавление кнопки и команды формы

Кнопка — частный случай, который вызывает больше всего вопросов, потому что требует трёх связанных сущностей: самой кнопки, команды формы и обработчика в модуле. В конфигураторе: на закладке «Команды» добавьте команду, задайте ей имя и действие, затем перетащите команду в дерево элементов — платформа создаст кнопку автоматически.

Обработчик команды создаётся кнопкой-магией в палитре свойств команды (поле «Действие»). Для клиентских процедур используйте директиву «&НаКлиенте», для работы с данными — «&НаСервере». Если обработчик отсутствует или директива не соответствует контексту, кнопка будет видна, но при нажатии выдаст ошибку либо ничего не сделает.

Доработка типовой формы без снятия с поддержки

Прямая правка формы типовой конфигурации приводит к частичному снятию объекта с поддержки: при обновлении форму придётся сравнивать и объединять вручную. Современная альтернатива — расширение конфигурации. Создайте расширение (меню «Конфигурация» → «Расширения конфигурации»), добавьте в него заимствованную форму нужного объекта и добавляйте элементы уже там.

В расширении доступны оба способа: визуальное добавление элементов в заимствованной форме и программное через аннотации «&После», «&Вместо» для обработчиков. Ограничение: нельзя удалять и переименовывать элементы основной конфигурации, только добавлять новые и менять часть свойств. Для большинства задач — вывести дополнительное поле или кнопку — этого достаточно.

Проверка результата и типичные проблемы

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

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

Частые вопросы