Размещение кнопки на форме 1С: 5 способов от базового до продвинутого

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

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

1. Базовый способ: добавление кнопки через конструктор формы

Самый простой метод — использование встроенного конструктора форм в 1С:Предприятие 8.3. Он не требует знания языка программирования и подходит для типовых задач, например, добавления кнопки "Печать" или "Экспорт в Excel".

Чтобы разместить кнопку:

• 📌 Откройте нужную форму в конфигураторе (через меню Объекты → Формы или двойным кликом по форме в дереве объектов).
• 🖱️ Перейдите на вкладку Элементы и нажмите Добавить → Кнопка (или перетащите элемент "Кнопка" из палитры элементов).
• ⚙️ В свойствах кнопки укажите:
  • Имя — уникальный идентификатор (например, КнопкаПечать).
  • Заголовок — текст, который будет отображаться на кнопке.
  • Действие — выберите из списка (например, Печать) или создайте своё.
• 📍 Перетащите кнопку на нужное место в макете формы (раздел Командная панель, Панель действий или непосредственно на форму).

Имя кнопки не содержит пробелов и кириллицы|

Заголовок кнопки понятен пользователю (не "Кнопка1")|

Кнопка привязана к команде или обработчику|

Проверено отображение на всех разрешении экрана-->

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

Через конструктор форм|

Через код на встроенном языке|

Смешанный (конструктор + доработка кодом)|

Использую внешние обработки-->

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

Если кнопка должна появляться только при определённых условиях (например, для пользователей с правами администратора) или её свойства нужно менять динамически, используйте встроенный язык 1С. Код размещается в модуле формы.

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

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

Ключевые моменты:

• 🔹 Код выполняется на клиенте (директива &НаКлиенте), так как работа с элементами формы возможна только в клиентском контексте.
• 🔹 Кнопка добавляется в КоманднуюПанель — стандартный контейнер для кнопок. Можно использовать и другие контейнеры (например, Панель).
• 🔹 Обработчик события (в данном случае СформироватьОтчет) должен быть заранее описан в модуле формы.

КоманднаяПанель.Элементы.Удалить("КнопкаСформироватьОтчет");

3. Добавление кнопки в командный интерфейс формы

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

Алгоритм:

1. Откройте форму в конфигураторе и перейдите на вкладку Команды.
2. Создайте новую команду (например, ОтправитьНаПроверку).
3. В свойствах команды укажите:
   • Имя — идентификатор команды.
   • Заголовок — текст для отображения.
   • Действие — обработчик на встроенном языке.
   • Группы команд — где будет отображаться (например, Форма.Действия).

&НаКлиенте
Процедура ОтправитьНаПроверку(Команда)
// Код обработки нажатия
КонецПроцедуры

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

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

Часто кнопки нужно показывать или скрывать в зависимости от состояния документа или прав пользователя. Например, кнопка "Провести" должна быть недоступна, если документ уже проведён.

Примеры управления свойствами:

&НаКлиенте
Процедура ОбновитьСостояниеКнопок()
КнопкаПровести = ЭлементыФормы.КнопкаПровести;

// Скрываем кнопку, если документ проведён
КнопкаПровести.Видимость = НЕ Объект.Проведен;

// Делаем кнопку недоступной, если нет прав
КнопкаПровести.Доступность = ПраваДоступа.ПроведениеДокументов;
КонецПроцедуры

Чтобы свойства обновлялись автоматически, вызовите эту процедуру в обработчиках событий:

• 🔄 ПриОткрытии — при первом открытии формы.
• 🔄 ПриИзменении — при изменении данных в форме.
• 🔄 ОбработкаПроверкиЗаполнения — при проверке введённых данных.

⚠️ Внимание: Если кнопка управляется через КомандныйИнтерфейс, её видимость и доступность лучше настраивать в обработчике ОбновлениеКомандногоИнтерфейса, а не напрямую в модуле формы. Это гарантирует корректную работу с учетом ролей.

5. Кнопки с выпадающим меню (SplitButton)

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

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

1. Создайте основную команду (например, Экспорт) и укажите для неё Тип = КомандаГруппы.
2. Добавьте дочерние команды (например, ЭкспортВExcel, ЭкспортВPDF) и свяжите их с основной через свойство Родитель.
3. В модуле формы опишите обработчики для каждой дочерней команды.

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

6. Типичные ошибки и их решение

Даже опытные разработчики сталкиваются с проблемами при работе с кнопками в 1С. Вот наиболее распространённые ошибки и способы их исправления:

• 🚫 Кнопка не отображается на форме:
  • Проверьте, что кнопка добавлена в правильный контейнер (например, КоманднаяПанель, а не просто на форму).
  • Убедитесь, что в свойстве Видимость установлено Истина.
  • Если кнопка добавлена через КомандныйИнтерфейс, проверьте настройки ролей пользователя.
• 🚫 Кнопка не реагирует на нажатие:
  • Проверьте, что обработчик события существует и корректно описан (например, &НаКлиенте для клиентских процедур).
  • Убедитесь, что в свойстве Действие указано правильное имя обработчика.
  • Если используется КомандныйИнтерфейс, проверьте, что команда не отключена в настройках интерфейса.
• 🚫 Кнопка "дергается" или меняет положение:
  • Закрепите кнопку в нужном месте формы, используя свойства ГоризонтальноеПоложение и ВертикальноеПоложение.
  • Избегайте динамического изменения размера кнопки — это может сбивать верстку.

⚠️ Внимание: Если вы используете управляемые формы, помните, что некоторые свойства кнопок (например, ЦветФона) могут не поддерживаться в веб-клиенте. Всегда тестируйте изменения в том режиме, в котором будет работать пользователь.

Для диагностики проблем используйте отладчик 1С (клавиша F5 в конфигураторе). Поставьте точку останова в обработчике кнопки и проверьте, выполняется ли код.

7. Оптимизация кнопок для мобильных устройств

С выходом 1С:Предприятие 8.3.20+ возросла актуальность адаптации форм под мобильные устройства. Кнопки на маленьких экранах должны быть:

• 📱 Достаточно крупными (рекомендуемый размер — не менее 48x48 px).
• 🎨 Контрастными (используйте ЦветФона и ЦветТекста для лучшей видимости).
• 📍 Размещёнными в нижней части экрана (зона доступа большим пальцем).

Пример адаптивного кода для кнопки:

&НаКлиенте
Процедура ПриОткрытии()
Если МобильноеПриложение() Тогда
КнопкаСохранить.Высота = 50;
КнопкаСохранить.Шрифт.Размер = 16;
КнопкаСохранить.ЦветФона = ВебЦвета.Зеленый;
КонецЕсли;
КонецПроцедуры

Для проверки отображения используйте эмулятор мобильного клиента в конфигураторе (Отладка → Мобильное приложение).

FAQ: Частые вопросы по кнопкам в 1С

Кнопка.Картинка = Новый Картинка("Справочник.ИконкаДобавить");

ДополнительнаяФорма = ПолучитьФорму("ДополнительныеКнопки.Эпф");
ДополнительнаяФорма.Открыть();

КоманднаяПанель.Элементы.Переместить("Кнопка1", 0); // Перемещает на первое место

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