Как сделать форму активной в 1С

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

Важно понимать разницу между «открыть форму» и «активировать форму». Открытие создаёт форму и показывает её пользователю, а активация лишь переводит фокус на уже существующую форму, не создавая новый экземпляр. Если форма не открыта, вызов активации ни к чему не приведёт — сначала форму нужно получить или открыть.

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

Что делает метод Активизировать()

Метод Активизировать() переводит фокус ввода на указанную форму и выводит её на передний план среди окон клиентского приложения. Пользователь сразу видит форму и может продолжить ввод данных без лишних щелчков мышью. Метод не имеет параметров и не возвращает значения.

Метод доступен как для управляемых форм (объект УправляемаяФорма), так и для обычных форм (объект Форма). Синтаксис одинаковый, различия касаются способа получения ссылки на форму и поведения окон.

// Управляемая форма
ФормаДокумента = ПолучитьФорму("Документ.РеализацияТоваровУслуг.ФормаОбъекта", ПараметрыФормы);
ФормаДокумента.Открыть();
ФормаДокумента.Активизировать();

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

Активация управляемой формы

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

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

Проверка, открыта ли форма

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

Если ФормаДокумента <> Неопределено И ФормаДокумента.Открыта() Тогда
    ФормаДокумента.Активизировать();
Иначе
    ОткрытьФорму("Документ.РеализацияТоваровУслуг.ФормаОбъекта", ПараметрыФормы);
КонецЕсли;

Активация обычной формы и работа с окнами

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

// Обычное приложение
Форма = Документы.РеализацияТоваровУслуг.ПолучитьФорму("ФормаДокумента");
Форма.Открыть();
Форма.Активизировать();

// Активация окна
Для Каждого Окно Из Окна Цикл
    Если Найти(Окно.Заголовок, "Реализация") > 0 Тогда
        Окно.Активизировать();
        Прервать;
    КонецЕсли;
КонецЦикла;

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

Активация элемента внутри формы

Иногда задача шире: не только показать форму, но и установить курсор в конкретное поле. Для этого у управляемой формы есть свойство ТекущийЭлемент — присвойте ему нужный элемент формы, и после активации фокус окажется в нём.

&НаКлиенте
Процедура ПоказатьИУстановитьФокус(Команда)
    Активизировать();
    ЭтаФорма.ТекущийЭлемент = Элементы.Комментарий;
КонецПроцедуры

В обычных формах аналогичную роль выполняет метод Активизировать() у элемента формы или установка текущего элемента через свойство формы. Проверяйте, что элемент видим и доступен — попытка передать фокус скрытому или недоступному элементу игнорируется либо приводит к непредсказуемому поведению.

1. 1
   Определите, открыта ли форма: вызовите Открыта() или проверьте ссылку на Неопределено
2. 2
   Если форма не открыта — откройте её через ОткрытьФорму() или ПолучитьФорму() с нужными параметрами
3. 3
   Вызовите у формы Активизировать()
4. 4
   При необходимости установите ТекущийЭлемент для передачи фокуса в конкретное поле
5. 5
   Проверьте визуально: форма на переднем плане, курсор в нужном поле

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

Самая частая ошибка — вызов Активизировать() на сервере. Активация формы имеет смысл только на клиенте, где существует интерфейс. В серверном контексте метод недоступен, и попытка его выполнить приведёт к ошибке компиляции или выполнения. Размещайте код активации в клиентских процедурах (директива &НаКлиенте).

Вторая распространённая проблема — активация модально или блокирующе открытой формы. Если форма открыта с РежимОткрытияОкна.БлокироватьВесьИнтерфейс, активировать другую форму поверх неё нельзя, пока блокирующая форма не закрыта. Это ограничение платформы, а не дефект кода.

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

Надёжный способ убедиться, что активация сработала, — визуальная проверка: форма выведена на передний план, её заголовок в панели задач подсвечен, а при установке ТекущийЭлемент курсор находится в нужном поле. Программного свойства «форма активна» у управляемой формы нет, поэтому ориентируйтесь на косвенные признаки.

Если активация не срабатывает без видимых ошибок, добавьте отладку: точку останова перед вызовом метода и проверку значения Форма.Открыта(). Это локализует проблему — либо форма не существует, либо её перекрывает модальное окно.

Когда активация не нужна

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

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