Как создать кнопку в конфигураторе 1С

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

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

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

Открываем форму объекта в конфигураторе

Запустите конфигуратор и откройте нужную информационную базу. В дереве конфигурации найдите объект, на форме которого должна появиться кнопка: документ, справочник, обработку или отчёт. Раскройте ветку объекта, затем ветку «Формы» и дважды щёлкните по нужной форме — чаще всего это «ФормаОбъекта» или «ФормаСписка».

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

Редактор формы состоит из нескольких областей: дерево элементов (слева вверху), список реквизитов и команд (справа), а также предпросмотр формы. Именно с этими областями идёт основная работа при добавлении кнопки.

Создаём команду формы для кнопки

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

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

В палитре свойств команды настройте заголовок (текст на кнопке), картинку, подсказку и сочетание клавиш при необходимости. Свойство «Отображение» определяет, как кнопка выглядит: текст, картинка или и то и другое.

Добавляем кнопку на форму

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

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

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

1. 1
   Откройте форму объекта в конфигураторе
2. 2
   На вкладке «Команды» добавьте новую команду формы и задайте имя и заголовок
3. 3
   Перетащите команду в дерево элементов — в командную панель или группу
4. 4
   Настройте свойства кнопки: картинку, видимость, положение
5. 5
   Напишите обработчик команды в модуле формы
6. 6
   Сохраните конфигурацию и проверьте кнопку в режиме предприятия

Пишем обработчик команды в модуле формы

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

Для клиентского обработчика используется директива &НаКлиенте. Если логика требует обращения к базе данных — записи, запросов, проведения — вызывайте из клиентской процедуры серверную с директивой &НаСервере:

&НаКлиенте
Процедура ЗаполнитьПоОстаткам(Команда)
ЗаполнитьПоОстаткамНаСервере();
ПоказатьОповещениеПользователя("Заполнение выполнено");
КонецПроцедуры

&НаСервере
Процедура ЗаполнитьПоОстаткамНаСервере()
// Запрос остатков и заполнение табличной части
КонецПроцедуры

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

&НаКлиенте
Процедура МояКоманда(Команда)
	ПоказатьПредупреждение(, "Кнопка нажата");
КонецПроцедуры

Программное создание кнопки из кода

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

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НоваяКоманда = Команды.Добавить("КомандаДинамическая");
НоваяКоманда.Действие = "Подключаемый_ОбработчикКоманды";
НоваяКоманда.Заголовок = "Сформировать";

НоваяКнопка = Элементы.Добавить("КнопкаДинамическая", Тип("КнопкаФормы"), Элементы.КоманднаяПанель);
НоваяКнопка.ИмяКоманды = "КомандаДинамическая";
КонецПроцедуры

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

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

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

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

Ограничения и безопасная работа с конфигурацией

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

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

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

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