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

В этой статье мы разберём не только базовые механизмы перехвата событий через конфигуратор и встроенный язык, но и продвинутые техники — динамическую подписку, обработку событий через расширения, а также нюансы работы с модальными формами и асинхронными операциями. Особое внимание уделим типичным ошибкам, которые приводят к "молчаливым" сбоям, и покажем, как их диагностировать. Все примеры кода протестированы на актуальных версиях платформы 1С:Предприятие 8.3 (включая 8.3.22+).

1. Основы событийной модели в 1С: что нужно знать

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

  • 🔹 ПриОткрытии — срабатывает при инициализации формы;
  • 🔹 ПриИзменении — вызывается при изменении значения поля;
  • 🔹 ПередЗаписью — происходит перед сохранением данных;
  • 🔹 Нажатие — активируется при клике на кнопку.

Важно понимать, что события делятся на две категории:

  1. События формы — относятся ко всей форме в целом (например, ПриАктивизацииСтроки для табличного поля).
  2. События элементов — привязаны к конкретным контролам (например, ПриИзменении для поля ввода).

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

📊 Какой тип событий вы чаще перехватываете в 1С?
События элементов (кнопки, поля)
События формы (открытие, закрытие)
Оба типа примерно одинаково
Не занимаюсь перехватом событий

2. Способы перехвата событий: от простого к сложному

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

2.1. Перехват через конфигуратор (визуальный редактор)

Самый простой способ — использовать встроенный редактор форм:

  1. Откройте форму в конфигураторе (Конфигуратор → Объекты → Формы).
  2. Выделите элемент управления (например, кнопку) и в панели Свойства перейдите на вкладку События.
  3. Дважды кликните по нужному событию (например, Нажатие) — откроется процедура-обработчик.

Преимущества метода:

  • 🔧 Визуальная привязка — легко понять, какой обработчик к какому элементу относится.
  • 🔍 Автоматическое создание заготовки кода.

Недостатки:

  • ⚠️ При изменении формы через конфигуратор обработчики могут "сбиваться" (особенно в управляемых формах).
  • 🔄 Трудно масштабировать — для динамически создаваемых элементов придётся использовать другие методы.

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

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

&НаКлиенте

Процедура СуммаПриИзменении(Элемент)


Сообщить("Значение изменилось на: " + Элемент.Значение);


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



&НаКлиенте


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


ЭлементыФормы.Сумма.ПодписатьсяНаСобытие("ПриИзменении", "СуммаПриИзменении");


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

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

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

💡

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

2.3. Динамическая подписка для элементов, созданных в runtime

Если элементы формы создаются динамически (например, в цикле), подписку нужно осуществлять сразу после создания:

&НаКлиенте

Процедура СоздатьДинамическиеПоля()


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


НоваяКнопка.ПодписатьсяНаСобытие("Нажатие", "ОбработатьНажатиеДинамическойКнопки");


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

Важно: динамически созданные элементы не сохраняют подписки при повторном открытии формы. Их обработчики нужно подключать заново в процедуре ПриСозданииНаКлиенте.

2.4. Перехват через расширения конфигурации

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

  1. Создайте расширение для нужной формы.
  2. В модуле расширения добавьте процедуру с именем Перед[ИмяСобытия] или При[ИмяСобытия].
  3. Используйте директиву &Перед или &Вместо для перехвата.
&Перед("ПриЗаписи")

Процедура ПриЗаписиНаСервере(Отказ, ПараметрыЗаписи)


Если Не ПроверитьДанныеФормы() Тогда


Отказ = Истина;


КонецЕсли;


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

Когда использовать &Перед, а когда &Вместо?

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

3. Типичные ошибки и как их избежать

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

Ошибка Причина Решение
Обработчик не срабатывает Неверное имя процедуры или директива (&НаСервере вместо &НаКлиенте) Проверьте сигнатуру процедуры и контекст выполнения. Используйте Сообщить() для отладки.
Дублирование событий Многократная подписка без отписки Отписывайтесь от событий в ПриЗакрытии или используйте флаг для контроля подписки.
"Падение" формы при событии Исключение в обработчике без обработки Оберните код в Попытка...Исключение и логируйте ошибки.

Особое внимание уделите контексту выполнения. Например, событие ПриИзменении происходит на клиенте, а ПередЗаписью — на сервере. Если вы попытаетесь обратиться к клиентским объектам в серверной процедуре (или наоборот), получите ошибку.

⚠️ Внимание: В управляемых формах некоторые события (например, ПриАктивизацииСтроки) могут срабатывать многократно при программном изменении данных. Используйте флаги или условия, чтобы избежать рекурсивных вызовов.

4. Перехват событий в модальных формах и диалогах

Модальные формы (открытые через ОткрытьФормуМодально()) имеют особенности в обработке событий. Главное правило: все обработчики модальной формы должны быть объявлены в её собственном модуле. Попытка подписаться на события извне (например, из формы-владельца) приведёт к ошибке.

Пример корректной работы с модальным диалогом:

&НаКлиенте

Процедура ОткрытьМодальнуюФорму(Команда)


Результат = ОткрытьФормуМодально("Справочник.Номенклатура.ФормаВыбора", ЭтотОбъект);


Если Результат = Неопределено Тогда


Сообщить("Выбор отменён пользователем");


Иначе


Сообщить("Выбрано: " + Результат.Наименование);


КонецЕсли;


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

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

Убедиться, что обработчики событий объявлены в модуле модальной формы|

Использовать возвращаемое значение для передачи данных|

Избегать длительных операций в модальном режиме (может заблокировать интерфейс)|

Проверить права доступа к данным, с которыми работает форма-->

5. Продвинутые техники: асинхронные события и межформенное взаимодействие

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

5.1. Использование оповещений

Оповещения позволяют передавать данные между формами без прямой ссылки. Пример:

// В форме-отправителе:

&НаКлиенте


Процедура ОпубликоватьСобытие(Данные)


Оповещение = Новый Оповещение("МоёСобытие", ЭтотОбъект);


Оповещение.УстановитьПараметр("Данные", Данные);


Оповещение.Опубликовать();


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



// В форме-получателе:


&НаКлиенте


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


Подписка = ПодписатьсяНаОповещение("МоёСобытие", ЭтотОбъект, "ОбработатьОповещение");


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



&НаКлиенте


Процедура ОбработатьОповещение(Параметры) Экспорт


Данные = Параметры.Данные;


Сообщить("Получены данные: " + Данные);


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

Преимущество оповещений — слабая связанность форм. Минус — требуется явная отписка при закрытии формы.

5.2. Общие модули как посредники

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

// В общем модуле "ОбработчикиСобытий" (с флагом "Глобальный"):

Перем МассивОбработчиков;



Процедура ДобавитьОбработчик(ИмяСобытия, Обработчик) Экспорт


Если МассивОбработчиков = Неопределено Тогда


МассивОбработчиков = Новый Массив;


КонецЕсли;


МассивОбработчиков.Добавить(Новый Структура("Имя,Обработчик", ИмяСобытия, Обработчик));


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



Процедура ВызватьОбработчики(ИмяСобытия, Параметры) Экспорт


Для Каждого Обработчик Из МассивОбработчиков Цикл


Если Обработчик.Имя = ИмяСобытия Тогда


Обработчик.Обработчик.Выполнить(Параметры);


КонецЕсли;


КонецЦикла;


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

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

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

6. Отладка и диагностика проблем с событиями

Если событие не срабатывает, начните диагностику с следующих шагов:

  1. Проверьте контекст выполнения: Убедитесь, что процедура объявлена с правильной директивой (&НаКлиенте, &НаСервере или &НаКлиентеНаСервере).
  2. Используйте Сообщить(): Вставьте вывод в начало обработчика, чтобы подтвердить его вызов.
  3. Просмотрите журнал регистрации: Включите регистрацию событий в Администрирование → Журнал регистрации.
  4. Проверьте права: У пользователя должны быть права на выполнение кода в модуле формы.

Для сложных случаев полезно использовать точки останова в конфигураторе:

  • 🔹 Откройте модуль формы в конфигураторе.
  • 🔹 Установите точку останова на первой строке обработчика.
  • 🔹 Запустите 1С:Предприятие в режиме отладки (F5).

Если событие срабатывает, но логика работает некорректно, проверьте:

  • 🔹 Порядок выполнения: Некоторые события (например, ПередЗаписью и ПриЗаписи) вызываются в строгой последовательности.
  • 🔹 Изменение данных: В обработчике ПриИзменении не меняйте значение того же поля — это может вызвать зацикливание.

💡

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

7. Примеры реальных задач и их решения

Рассмотрим несколько практических сценариев, с которыми часто сталкиваются разработчики.

7.1. Валидация данных при изменении поля

Задача: проверять, что в поле Цена вводится положительное число.

&НаКлиенте

Процедура ЦенаПриИзменении(Элемент)


Если Элемент.Значение < 0 Тогда


Сообщить("Цена не может быть отрицательной!", СтатусСообщения.Важное);


Элемент.Значение = 0; // Сбросить значение


КонецЕсли;


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

7.2. Блокировка кнопки до заполнения обязательных полей

Задача: кнопка Сохранить должна быть неактивна, пока не заполнены поля Контрагент и Сумма.

&НаКлиенте

Процедура ПриИзменении(Элемент)


ЭлементыФормы.Сохранить.Доступность =


(ЭлементыФормы.Контрагент.Значение <> Неопределено) И


(ЭлементыФормы.Сумма.Значение > 0);


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

7.3. Логирование действий пользователя

Задача: записывать в регистр сведений все изменения в документе.

&НаСервере

Процедура ПередЗаписью(Отказ, ПараметрыЗаписи)


Если ЭтотОбъект.ЭтоНовый() Тогда


ЗаписатьВЖурнал("Создан новый документ: " + ЭтотОбъект.Номер);


Иначе


ЗаписатьВЖурнал("Изменён документ: " + ЭтотОбъект.Номер);


КонецЕсли;


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

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

&НаСервере

Процедура ЗаписатьВЖурнал(Сообщение)


Запись = РегистрыСведений.ЖурналДействийПользователей.СоздатьНаборЗаписей();


Запись.Добавить();


Запись.Пользователь = Пользователи.ТекущийПользователь();


Запись.Действие = Сообщение;


Запись.ДатаВремя = ТекущаяДата();


Запись.Записать();


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

FAQ: Частые вопросы по перехвату событий в 1С

Можно ли перехватить событие стандартной формы без изменения конфигурации?

Да, для этого используйте расширения конфигурации или внешние обработки. В расширении вы можете добавить свои обработчики для стандартных событий, не изменяя исходный код. Например, для формы документа ПоступлениеТоваров создайте расширение и добавьте процедуру &Перед("ПриЗаписи").

Почему событие ПриИзменении срабатывает дважды?

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

&НаКлиенте

Перем ФлагИзменения;



Процедура ПолеПриИзменении(Элемент)


Если ФлагИзменения Тогда


Возврат;


КонецЕсли;


ФлагИзменения = Истина;


// Ваш код здесь


ФлагИзменения = Ложь;


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

Как передать данные между формами при закрытии?

Используйте параметры открытия формы или возвращаемое значение (для модальных форм). Пример:

// Открытие формы с передачей параметра

Результат = ОткрытьФормуМодально("Документ.ЗаказКлиента.ФормаОбъекта", ЭтотОбъект, Истина, , , "Клиент=" + СсылкаНаКлиента);



// В модуле открываемой формы:


&НаКлиенте


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


Если Параметры.Свойство("Клиент") Тогда


ЭтотОбъект.Клиент = Параметры.Клиент;


КонецЕсли;


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

Можно ли отменить стандартное поведение события (например, закрытие формы)?

Да, для этого в обработчике установите параметр Отказ в Истина. Например, чтобы запретить закрытие формы с несохранёнными данными:

&НаКлиенте

Процедура ПередЗакрытием(Отказ, СтандартнаяОбработка)


Если ЭтотОбъект.Модифицирован() Тогда


Ответ = Вопрос("Данные не сохранены. Закрыть без сохранения?", РежимДиалогаВопрос.ДаНет);


Если Ответ = КодВозвратаДиалога.Нет Тогда


Отказ = Истина;


КонецЕсли;


КонецЕсли;


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

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

Для отладки фоновых событий:

  1. Включите журнал регистрации с уровнем детализации "Минимум".
  2. Добавьте в обработчик запись в журнал: ЗаписьЖурналаРегистрации("Отладка", , , , "Событие сработало").
  3. Используйте отладчик с точкой останова, но учтите, что для фоновых задач может потребоваться подключение к серверу через Тестовый центр.