Другое · 5 мин
Как программно закрыть текущую форму в 1С
Программное закрытие текущей формы в 1С: способы вызова, условия работы, ограничения и частые ошибки при закрытии окон из модуля формы на платформе.
Когда требуется программное закрытие формы
Текущая форма в 1С — окно, с которым работает пользователь в данный момент. Программное закрытие нужно, когда после выполнения действия окно должно исчезнуть без участия пользователя: сохранение документа, завершение ввода, переход к другой форме по условию или отмена операции.
Закрытие может быть инициировано из модуля самой формы, из обработчика команды, из внешнего кода по ссылке на форму или из общего модуля. Выбор способа зависит от того, где выполняется код, есть ли доступ к объекту формы и какая форма открыта: модальная или обычная.
Важно понимать, что программное закрытие не заменяет сохранение данных. Если форма содержит несохранённый ввод, закрытие окна может привести к потере введённых значений, если перед закрытием не выполнена проверка и запись.
Закрытие формы из собственного модуля
Если код выполняется в модуле формы, доступ к текущей форме обычно осуществляется через системную ссылку ЭтаФорма. Вызов метода закрытия у этой ссылки приводит к завершению работы окна, если платформа и контекст позволяют выполнить операцию.
Типичный паттерн выглядит как проверка условий перед закрытием: например, убедиться, что обязательные реквизиты заполнены, данные записаны, а затем вызвать закрытие. Если проверка не пройдена, закрытие лучше отменить и сообщить пользователю о причине.
ЭтаФорма.Закрыть();Закрытие формы извне по ссылке
Извне формы повлиять на окно можно только если есть объект формы, полученный при открытии или через механизмы получения форм приложения. Без такой ссылки стандартными средствами закрыть конкретное окно пользователя сложно и не всегда безопасно.
Если форма открыта модально, выполнение кода в вызывающем месте может быть приостановлено до закрытия окна. Попытка закрыть модальную форму из её же обработчика может привести к неочевидному поведению, поэтому порядок действий нужно проверять в конкретной конфигурации.
Сравнение вариантов закрытия
Подходит для действий, инициированных внутри окна; требует доступа к модулю формы и учёта модальности.
Подходит при управлении формой из другого кода; возможен только при наличии полученной ранее ссылки на объект формы.
Удобен для реакции на действия пользователя; не всегда подходит для принудительного закрытия без проверки данных.
Модальные и обычные формы: особенности поведения
Модальная форма блокирует взаимодействие с остальным интерфейсом до своего закрытия. Программное закрытие такой формы может разблокировать вызывающий код, но если закрытие происходит в процессе обработки события, дальнейшие действия формы могут не выполниться.
Обычная не модальная форма позволяет пользователю переключаться между окнами. Закрытие такой формы программным способом менее критично для последовательности выполнения, но всё равно может прервать ввод или отменить несохранённые изменения.
Ограничения и границы безопасной работы
Не все формы можно закрыть программно без последствий. В некоторых конфигурациях закрытие формы может прервать выполнение отчёта, обработки или обмена данными, если форма участвует в цепочке вызовов. Также существуют права доступа и правила блокировки объектов, которые могут помешать завершению операции.
Повторное закрытие уже закрытой формы или вызов закрытия в рекурсивном обработчике может привести к ошибкам выполнения. Перед программным закрытием стоит убедиться, что форма ещё открыта, нет активных модальных окон на ней и нет несохранённых изменений.
Частые ошибки и проверка результата
Одна из типичных ошибок — попытка закрыть форму, к которой нет доступа, или вызов метода у несуществующей ссылки. Это приводит к ошибке выполнения или просто к отсутствию реакции. Другая ошибка — закрытие окна до завершения записи документа, что отменяет введённые пользователем данные.
Результат проверяется визуально: окно должно исчезнуть, управление должно вернуться к вызывающей форме или главному меню, а данные должны остаться записаны. Если форма остаётся открытой, нужно проверить наличие исключений, условий отмены и правильность ссылки на форму.
Что важно запомнить
Закрытие текущей формы выполняется через объект формы, чаще всего ЭтаФорма из модуля формы; извне нужна ссылка, перед закрытием проверяйте сохранение данных и модальность окна.
Можно ли закрыть форму, открытую другим пользователем?
Нет, стандартными средствами формы пользователя в его сеансе недоступны для прямого программного закрытия извне. Управление возможно только в рамках текущего сеанса и по имеющейся ссылке на форму.
Что делать, если форма не закрывается после вызова метода?
Проверьте, не отменяется закрытие обработчиком события, не открыты ли модальные окна поверх формы, не остались ли несохранённые данные и корректна ли ссылка на форму. Также убедитесь, что код выполняется в допустимом контексте.
Безопасно ли закрывать форму во время записи документа?
Не всегда. Прежде чем закрывать форму, завершите запись данных или отмените изменения явно, иначе введённая информация может быть потеряна. Порядок действий зависит от конфигурации.
Нужно ли проверять права доступа перед программным закрытием?
Да, если закрытие затрагивает закрытие объектов, проведение документов или изменение состояния, права доступа и правила блокировки могут повлиять на возможность выполнения операции.