Создание кнопки в 1С: подробное руководство с примерами кода

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

Мы рассмотрим не только базовые методы, но и нюансы, которые часто упускают начинающие разработчики. Например, почему кнопка может не отображаться в форме, как правильно привязать обработчик события, и какие свойства стоит настроить для корректной работы. Особое внимание уделим типичным ошибкам, которые приводят к сбоям или некорректному поведению интерфейса.

Статья будет полезна как новичкам, которые только осваивают 1С, так и опытным специалистам, желающим систематизировать знания. Все примеры актуальны для платформы 1С:Предприятие 8.3 (включая последние релизы), но большинство методов применимы и к более ранним версиям.

Способы создания кнопок в 1С: обзор вариантов

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

• 🔧 Через конструктор форм — самый простой способ для новичков. Подходит, если нужно быстро добавить кнопку в существующую форму без написания кода.
• 💻 Программное создание в модуле — гибкий метод, позволяющий динамически формировать кнопки в зависимости от условий (например, прав пользователя или данных документа).
• 📋 С помощью командной панели — используется для добавления кнопок в стандартные формы (например, в формы списков или документов).
• 🔄 Через внешние обработки — актуально, если нужно добавить кнопку без изменения типовой конфигурации (например, в 1С:Бухгалтерия или 1С:ЗУП).

Каждый метод имеет свои плюсы и минусы. Например, конструктор форм удобен для быстрых правок, но не позволяет гибко настраивать логику. Программное создание требует знания языка 1С, зато даёт полный контроль над поведением кнопки. А командная панель часто используется для интеграции кнопок в стандартные интерфейсы без глубоких доработок.

Прежде чем выбрать способ, определите:

• 🔹 Нужно ли изменять типовую конфигурацию или можно обойтись внешней обработкой?
• 🔹 Должна ли кнопка появляться только при определённых условиях (например, для администраторов)?
• 🔹 Требуется ли сложная логика при нажатии (вызов обработки, открытие формы, проверка данных)?

Создание кнопки через конструктор форм

Это самый простой и наглядный способ добавить кнопку в форму 1С. Он не требует написания кода и подходит для большинства типовых задач. Рассмотрим пошаговую инструкцию на примере добавления кнопки в форму документа.

Откройте конфигуратор 1С и выполните следующие действия:

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

После добавления кнопки необходимо создать обработчик события Нажатие. Для этого:

1. В дереве элементов формы выделите созданную кнопку.
2. В панели свойств найдите событие Нажатие и нажмите на кнопку с тремя точками (...).
3. В открывшемся модуле формы добавьте код обработчика. Например, для печати счёта:

Процедура КнопкаПечатьСчетаНажатие(Кнопка)
ПечатьСчета(Объект);
КонецПроцедуры

Где ПечатьСчета — это ваша процедура, которая формирует и выводит печатную форму.

Убедитесь, что имя кнопки уникально|Проверьте, что обработчик события указан правильно|Сохраните форму (Ctrl+S)|Запустите 1С в режиме предприятия для тестирования-->

Программное создание кнопки в модуле формы

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

Рассмотрим пример добавления кнопки в форму документа РеализацияТоваровУслуг при открытии формы. Кнопка будет видна только если документ проведён:

Процедура ПриОткрытии(Отказ)
// Проверяем, проведён ли документ
Если Объект.Проведен Тогда
// Создаём кнопку программно
Кнопка = ЭлементыФормы.Добавить("КнопкаОтправитьПоEmail",
Тип("КнопкаФормы"),
ЭтотОбъект,
"КнопкаОтправитьПоEmail");

// Настраиваем свойства кнопки
Кнопка.Заголовок = "Отправить по Email";
Кнопка.Положение = ПоложениеЭлементаФормы.СнизуСлева;
Кнопка.Ширина = 150;
Кнопка.Высота = 25;

// Привязываем обработчик
Кнопка.Действие = "КнопкаОтправитьПоEmailНажатие";
КонецЕсли;
КонецПроцедуры

Процедура КнопкаОтправитьПоEmailНажатие(Кнопка)
ОтправитьДокументПоEmail(Объект);
КонецПроцедуры

В этом примере:

• 🔹 Кнопка создаётся только если документ проведён (Объект.Проведен).
• 🔹 Метод ЭлементыФормы.Добавить добавляет новый элемент на форму.
• 🔹 Свойства Положение, Ширина и Высота задают внешний вид кнопки.
• 🔹 Обработчик КнопкаОтправитьПоEmailНажатие вызывает процедуру отправки email.

Преимущества программного создания:

• 🔹 Можно динамически изменять видимость кнопки (Кнопка.Видимость = Ложь).
• 🔹 Легко настраивать разные действия для разных условий.
• 🔹 Можно создавать кнопки "на лету" без изменения конфигурации (через внешние обработки).
💡

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

Добавление кнопки через командную панель

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

Рассмотрим, как добавить кнопку в командную панель формы списка справочника Номенклатура:

1. Откройте конфигуратор и перейдите в ветку Объекты → Справочники → Номенклатура.
2. Откройте форму списка справочника (Формы → Форма списка).
3. В конструкторе форм найдите элемент КоманднаяПанель (обычно он расположен вверху формы).
4. Выделите командную панель и в панели свойств найдите коллекцию Команды.
5. Нажмите на кнопку добавления новой команды (+) и настройте её:
   • 🔹 Имя — КомандаЭкспортВExcel.
   • 🔹 Заголовок — Экспорт в Excel.
   • 🔹 Действие — укажите обработчик (например, КомандаЭкспортВExcelВыполнить).
   • 🔹 Изображение — можно выбрать иконку из стандартной библиотеки.

Теперь добавьте обработчик команды в модуль формы:

Процедура КомандаЭкспортВExcelВыполнить(Команда)
ЭкспортВExcel(ЭлементыФормы.Список);
КонецПроцедуры

Где ЭкспортВExcel — ваша процедура для выгрузки данных в Excel.

Особенности работы с командной панелью:

• 🔹 Кнопки в командной панели автоматически адаптируются под интерфейс 1С (например, в Такси или Управляемом приложении).
• 🔹 Можно группировать команды по категориям (например, Отчёты, Действия).
• 🔹 Поддерживаются горячие клавиши (СочетаниеКлавиш).

Процедура ПриОткрытии(Отказ)
Если НЕ ГлобальныйКонтекст.Пользователь.Роли.Найти("Администратор") Тогда
ЭлементыФормы.КоманднаяПанель.Команды.КомандаЭкспортВExcel.Видимость = Ложь;
КонецЕсли;
КонецПроцедуры

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

При создании кнопок в 1С разработчики часто сталкиваются с типичными проблемами. Рассмотрим наиболее распространённые ошибки и способы их исправления.

Ещё несколько нюансов:

• 🔹 Если кнопка добавляется программно, но исчезает после обновления формы, проверьте, не пересоздаётся ли форма при изменении данных. В этом случае логику создания кнопки нужно перенести в обработчик ПриАктивизацииСтроки или ПриИзмененииДанных.
• 🔹 В управляемых формах не работают некоторые свойства обычных форм (например, ТипКнопки). Используйте КнопкаФормы вместо Кнопка.
• 🔹 Для кнопок в командной панели проверьте, что команда добавлена в коллекцию Команды именно той панели, которая отображается на форме.
💡

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

Создание кнопки во внешней обработке

Если вы работаете с типовой конфигурацией (например, 1С:Бухгалтерия или 1С:Зарплата и Управление Персоналом) и не хотите изменять её код, можно добавить кнопку через внешнюю обработку. Это безопасный способ расширить функционал без снятия поддержки.

Алгоритм действий:

1. Создайте новую внешнюю обработку (Файл → Новый → Внешняя обработка).
2. В конструкторе обработки добавьте форму и разместите на ней кнопку (аналогично методу через конструктор форм).
3. Напишите код обработчика нажатия. Например, для загрузки данных из файла:

Процедура КнопкаЗагрузитьДанныеНажатие(Кнопка)
ПутьКФайлу = ПолучениеИмениФайлаДляОткрытия("Выберите файл для загрузки", "", "Текстовые файлы|.txt;.csv");
Если НЕ ПутьКФайлу = Неопределено Тогда
ЗагрузитьДанныеИзФайла(ПутьКФайлу);
КонецЕсли;
КонецПроцедуры

Чтобы подключить обработку к типовой конфигурации:

1. Сохраните обработку в файл (.epf).
2. В пользовательском режиме 1С откройте меню Файл → Открыть и выберите сохранённый файл.
3. Обработка откроется как внешняя форма, и пользователь сможет ею воспользоваться.

Преимущества внешних обработок:

• 🔹 Не требуется изменять типовую конфигурацию (сохраняется поддержка от 1С).
• 🔹 Можно быстро обновлять логику без перезапуска базы.
• 🔹 Удобно для тестирования новых функций перед внедрением в конфигурацию.

Ограничения:

• 🔹 Пользователь должен вручную открывать обработку (не подходит для автоматических действий).
• 🔹 Невозможно интегрировать кнопку в стандартные формы без доработок.
💡

Чтобы внешняя обработка открывалась автоматически при запуске 1С, добавьте её в список автозагрузки через параметр запуска /Execute или настройте расширение конфигурации.

Расширенные возможности: стили и события кнопок

Кнопки в 1С поддерживают не только базовые свойства (например, Заголовок или Видимость), но и расширенные настройки стиля и обработки событий. Это позволяет создавать более удобный и наглядный интерфейс.

Рассмотрим ключевые свойства и методы:

• 🎨 Стили кнопки:
  • 🔹 ЦветФона — задаёт фоновый цвет (например, ЦветФона = ВебЦвета.Зелёный).
  • 🔹 ЦветТекста — цвет текста на кнопке.
  • 🔹 Шрифт — настройка гарнитуры и размера текста.
  • 🔹 Картинка — добавление иконки (можно выбрать из стандартной библиотеки или загрузить свою).
• 🔄 События кнопки:
  • 🔹 Нажатие — основное событие, срабатывает при клике.
  • 🔹 ПриАктивизацииЭлемента — когда кнопка получает фокус.
  • 🔹 ПриИзмененииДоступности — при изменении свойства Доступность.

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

Кнопка = ЭлементыФормы.КнопкаОтправить;
Кнопка.ЦветФона = ВебЦвета.Голубой;
Кнопка.ЦветТекста = ВебЦвета.Белый;
Кнопка.Шрифт = Новый Шрифт("Segoe UI", 10, True, False, False);
Кнопка.Картинка = БиблиотекаКартинок.ОтправитьПисьмо;

Для динамического изменения стиля в зависимости от условий используйте обработчик ПриОткрытии:

Процедура ПриОткрытии(Отказ)
Если Объект.СуммаДокумента > 100000 Тогда
ЭлементыФормы.КнопкаПодтвердить.ЦветФона = ВебЦвета.Красный;
ЭлементыФормы.КнопкаПодтвердить.Заголовок = "Требуется подтверждение руководителя!";
КонецЕсли;
КонецПроцедуры

Также можно использовать состояния кнопки:

• 🔹 Нажата — визуально показывает, что кнопка активна.
• 🔹 ПоУмолчанию — кнопка выделяется как основное действие (например, ОК в диалоговом окне).
• 🔹 АвтоПовтор — позволяет удерживать кнопку для повторного срабатывания (актуально для кнопок увеличения/уменьшения значения).
Как сделать кнопку с выпадающим меню?

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

Кнопка = ЭлементыФормы.Добавить("КнопкаДействия",
Тип("КнопкаСМеню"),
ЭтотОбъект,
"КнопкаДействия");

Кнопка.Заголовок = "Действия";
Кнопка.Меню.Добавить("Печать", "ПечатьДокумента");
Кнопка.Меню.Добавить("ОтправитьEmail", "ОтправитьДокументПоEmail");

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

Как сделать кнопку неактивной (серой) до выполнения условия?

Используйте свойство Доступность. Например, чтобы кнопка КнопкаСохранить была активна только если заполнено поле Контрагент:

Процедура ПриИзмененииКонтрагента(Элемент)
ЭлементыФормы.КнопкаСохранить.Доступность = (ЭлементыФормы.Контрагент.Значение <> Неопределено);
КонецПроцедуры

Также можно управлять доступностью в обработчике ПриОткрытии или ПриИзмененииДанных.

Можно ли добавить кнопку в печатную форму документа?

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

1. Создание обработки с кнопкой, которая открывает печатную форму.
2. Использование ActiveX-компонентов для встраивания интерактивных элементов (например, в Excel-отчёты).
3. Генерацию HTML-отчётов с кнопками (для веб-клиента).

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

Как сделать, чтобы кнопка появлялась только для администраторов?

Проверяйте роль пользователя в обработчике ПриОткрытии формы:

Процедура ПриОткрытии(Отказ)
Если НЕ ГлобальныйКонтекст.Пользователь.Роли.Найти("Администратор") Тогда
ЭлементыФормы.КнопкаАдминистрирование.Видимость = Ложь;
КонецЕсли;
КонецПроцедуры

Альтернативно можно использовать права доступа на уровне конфигурации, но это потребует изменения ролей.

Почему кнопка в управляемой форме не реагирует на нажатие?

Возможные причины:

1. Не указан обработчик в свойстве Действие.
2. Ошибка в коде обработчика (проверьте через отладчик, F5).
3. Кнопка добавлена программно, но форма перерисовывается (например, при изменении данных). В этом случае логику создания кнопки нужно перенести в обработчик ПриСозданииНаСервере.
4. Свойство Видимость или Доступность установлено в Ложь.

Для диагностики добавьте в обработчик временное сообщение:

Процедура КнопкаТестНажатие(Кнопка)
Сообщить("Кнопка нажата!"); // Тестовое сообщение
КонецПроцедуры

Как добавить кнопку в форму отчёта?

В формах отчётов кнопки добавляются аналогично другим формам, но с учётом особенностей:

1. Откройте форму отчёта в конфигураторе (Объекты → Отчёты → [ВашОтчёт] → Формы → ФормаОтчёта).
2. Добавьте кнопку через конструктор или программно в обработчике ПриСозданииНаСервере.
3. Для кнопок, которые должны работать с данными отчёта, используйте серверные процедуры (например, для экспорта результатов в Excel).

Пример кнопки для экспорта отчёта:

Процедура КнопкаЭкспортНажатие(Кнопка)
ЭкспортТаблицыВExcel(Отчёт.Результат);
КонецПроцедуры