Как вызвать обработчик события формы в 1С

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

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

Как устроены обработчики событий формы

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

Обработчик — это не магическая конструкция, а обычная процедура с заранее определённым набором параметров. Например, ПриОткрытии(Отказ) получает параметр Отказ, а ПриИзменении элемента формы получает параметр Элемент. Если вы вызываете обработчик вручную, вы обязаны передать эти параметры сами — платформа этого за вас не сделает.

События делятся на события самой формы, события элементов формы (полей, таблиц, кнопок) и события реквизита объекта. У каждой группы свой набор параметров и свой контекст исполнения.

Вызов обработчика внутри модуля формы

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

Здесь важно помнить о параметрах. Если обработчик ПолеКонтрагентПриИзменении(Элемент) ожидает ссылку на элемент формы, при ручном вызове нужно передать либо реальный элемент (Элементы.Контрагент), либо Неопределено — но тогда внутри обработчика должна быть проверка, иначе код упадёт с ошибкой обращения к свойствам.

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

&НаКлиенте
Процедура ОбновитьДанные(Команда)
	// Вручную вызываем обработчик изменения поля
	КонтрагентПриИзменении(Элементы.Контрагент);
КонецПроцедуры

Вызов обработчика из другой формы

Обратиться к модулю другой формы напрямую нельзя — формы изолированы. Но есть рабочие способы. Первый: получить форму через ПолучитьФорму() или передать её как параметр при открытии, а затем вызвать её экспортную процедуру (объявленную с ключевым словом Экспорт).

Второй способ — механизм оповещений. Форма-источник вызывает Оповестить("ИмяСобытия", Параметры, Источник), а форма-приёмник обрабатывает это событие в обработчике ОбработкаОповещения(ИмяСобытия, Параметр, Источник). Это стандартный и самый безопасный путь, когда формы не знают друг о друге напрямую.

Третий вариант — ОписаниеОповещения. При открытии формы через ОткрытьФорму() можно передать описание оповещения, которое выполнится после закрытия формы. Так родительская форма получает результат и запускает нужный обработчик у себя.

1. 1
   В модуле целевой формы объявите процедуру с ключевым словом Экспорт
2. 2
   В вызывающем коде получите форму через ПолучитьФорму() или сохраните ссылку на неё при открытии
3. 3
   Вызовите метод: Форма.ИмяПроцедуры(Параметры)
4. 4
   Проверьте, что форма открыта — вызов метода закрытой формы приведёт к ошибке

Контекст клиента и сервера

Главный источник ошибок при ручном вызове обработчиков — несовпадение контекстов. Директивы &НаКлиенте, &НаСервере, &НаСервереБезКонтекста определяют, где выполняется код и что ему доступно. Клиентский обработчик не имеет доступа к запросам и объектным данным напрямую, а серверный без контекста — к данным формы.

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

Для вызова серверной процедуры из общего модуля используйте общие модули с флагом «Сервер» или «Вызов сервера». Из клиентского кода доступны только общие модули с установленным свойством «Вызов сервера».

Правильный приём: вынос логики в отдельную процедуру

Лучшая практика вместо ручного вызова обработчика — вынести его содержимое в отдельную процедуру с говорящим именем, а обработчик оставить тонкой обёрткой. Например, обработчик КонтрагентПриИзменении вызывает ЗаполнитьДанныеПоКонтрагенту(), и эту же процедуру можно вызвать из любого другого места без подделки параметров события.

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

Если логика нужна нескольким формам, вынесите её в общий модуль. Обработчики форм будут только передавать туда данные формы и получать результат.

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

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

Частые ошибки: вызов клиентской процедуры из серверного контекста (ошибка компиляции или выполнения), передача Неопределено вместо Элемент без проверки внутри обработчика, обращение к закрытой форме извне, вызов обработчика до завершения создания формы. Ещё одна типичная проблема — рекурсия: обработчик изменения поля вызывает код, который снова меняет это поле и снова запускает обработчик.

FAQ