1С: как получить открытые формы программно

Во встроенном языке 1С задача «получить открытые формы» решается несколькими способами, и выбор зависит от режима работы: обычное приложение или управляемое приложение, толстый или тонкий клиент. В обычном приложении доступны глобальные методы ПолучитьОкна() и АктивноеОкно(), которые возвращают коллекцию окон и активное окно соответственно. В управляемом приложении прямого перебора всех открытых форм нет — там работают через уникальность форм, владельца формы и параметр КлючУникальности.

Типовые сценарии, где это нужно: проверить, не открыта ли уже форма элемента, чтобы не плодить дубликаты; активировать существующее окно вместо открытия нового; закрыть все вспомогательные формы при завершении обработки; найти форму-владельца для передачи данных. Ниже разобраны конкретные методы с примерами кода и ограничениями каждого подхода.

Важно сразу разделить два понятия: «окна» — это объекты интерфейса клиентского приложения, а «формы» — объекты конфигурации. Одно окно может содержать одну форму, и методы работы с окнами доступны не везде. Именно из-за этой разницы код, написанный для обычного приложения, часто не компилируется в управляемом.

Как работает ПолучитьОкна() в обычном приложении

Метод ПолучитьОкна() — глобальный, вызывается на клиенте и возвращает коллекцию объектов типа «ОкноКлиентскогоПриложения». Доступен только в обычном приложении (толстый клиент). Каждый элемент коллекции содержит свойства: Заголовок, Содержимое (коллекция форм в окне), Активно, ВидОкна и другие.

Типовой перебор выглядит так:

Окна = ПолучитьОкна();
Для Каждого Окно Из Окна Цикл
Сообщить(Окно.ПолучитьЗаголовок());
Для Каждого Форма Из Окно.Содержимое Цикл
Сообщить(Форма.ИмяФормы);
КонецЦикла;
КонецЦикла;

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

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

Окна = ПолучитьОкна();
Для Каждого Окно Из Окна Цикл
    Для Каждого Форма Из Окно.Содержимое Цикл
        Сообщить(Форма.ИмяФормы);
    КонецЦикла;
КонецЦикла;

АктивноеОкно() и АктивнаяФорма()

Если нужна не вся коллекция, а только текущее окно, используйте АктивноеОкно(). Метод возвращает объект окна, которое сейчас активно, либо Неопределено, если активного окна нет. Через него можно получить форму: АктивноеОкно().Содержимое[0].

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

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

Как получить открытую форму в управляемом приложении

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

Первый — ключ уникальности. При вызове ОткрытьФорму() передайте параметр Уникальность — произвольное значение (строка, ссылка, УникальныйИдентификатор). Если форма с таким ключом уже открыта, платформа не создаст новую, а активирует существующую. Фактически это и есть «поиск открытой формы», встроенный в платформу.

ОткрытьФорму("Справочник.Номенклатура.Форма.ФормаЭлемента",
ПараметрыФормы, , СсылкаНаЭлемент); // четвёртый параметр — Уникальность

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

Третий — метод ПолучитьФорму() с указанием ключа уникальности. Если форма с таким ключом уже существует, ПолучитьФорму() вернёт именно её, а не создаст новую:

Форма = ПолучитьФорму("Обработка.МояОбработка.Форма.ФормаНастроек",
, , "КлючНастроек");
Если Не Форма.Открыта() Тогда
Форма.Открыть();
Иначе
Форма.Активизировать();
КонецЕсли;

Поиск формы конкретного объекта

Частая задача: перед открытием карточки элемента проверить, не открыта ли она уже. В управляемом приложении это решается ключом уникальности — стандартные формы объектов по умолчанию используют ссылку как ключ, поэтому повторное открытие того же элемента просто активирует существующую форму. Это поведение платформы по умолчанию, ничего программировать не нужно.

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

ОткрытьФорму("Обработка.ЗагрузкаДанных.Форма.ФормаЗагрузки",
, , "ЕдинственныйЭкземпляр");

В обычном приложении поиск делается перебором: проходите ПолучитьОкна(), у каждого окна смотрите Содержимое, сравниваете ИмяФормы и, если форма объектная, значение ключевого реквизита (например, Ссылка объекта).

1. 1
   Определите значение, однозначно идентифицирующее экземпляр формы: ссылку, строку или УникальныйИдентификатор
2. 2
   Передайте это значение в параметр Уникальность при вызове ОткрытьФорму()
3. 3
   Проверьте поведение: повторный вызов должен активировать уже открытую форму, а не создавать новую
4. 4
   Если нужна реакция на повторное открытие — обработайте его в форме через ОбработкаОповещения или ПриПовторномОткрытии

Оповещения как альтернатива поиску форм

Часто «найти открытую форму» нужно не ради самой формы, а чтобы передать ей данные — например, обновить список после записи элемента. Для этого перебирать формы не нужно: используйте механизм оповещений Оповестить() и ОповеститьОбИзменении().

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

Для стандартных объектов ещё проще: ОповеститьОбИзменении(Ссылка) автоматически заставит все открытые формы, показывающие этот объект или связанные списки, обновиться. Это основной рекомендуемый способ синхронизации в управляемом приложении.

Типичные ошибки и ограничения

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

Вторая — сравнение форм по заголовку. Заголовок может меняться пользователем, локализацией и состоянием объекта. Надёжные признаки: ИмяФормы, ключ уникальности, ссылка на объект.

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

Как проверить результат

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

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

Частые вопросы