Как добавить кнопку на форму в 1С: полное руководство

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

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

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

Где создаются кнопки: структура управляемой формы

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

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

Добавление кнопки через конфигуратор

Основной способ — доработка формы в конфигураторе. Порядок действий одинаков для формы документа, справочника и большинства других объектов.

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

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

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

Настройка внешнего вида кнопки

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

Для кнопок в командной панели типовых конфигураций принято использовать картинки из стандартной библиотеки, чтобы интерфейс выглядел единообразно. Свойство «СочетаниеКлавиш» позволяет назначить горячие клавиши, например Ctrl+Shift+P для печати.

Программное добавление кнопки

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

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

	// Создаём команду
	НоваяКоманда = Команды.Добавить("КомандаПечатьАкта");
	НоваяКоманда.Заголовок = "Печать акта";
	НоваяКоманда.Действие = "Подключаемый_ПечатьАкта";

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

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

&НаКлиенте
Процедура Подключаемый_ПечатьАкта(Команда)

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

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

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

Добавление кнопки через расширение конфигурации

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

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

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

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

FAQ