Как свернуть окно 1С программно

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

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

Почему в 1С нет штатного метода сворачивания окна

Встроенный язык 1С работает с прикладными объектами — документами, справочниками, формами, — а не с окнами операционной системы. Управление состоянием главного окна приложения (свернуть, развернуть, изменить размер) относится к уровню ОС, и платформа сознательно не даёт прямого доступа к этим функциям из соображений кроссплатформенности: один и тот же код должен выполняться на Windows, Linux и в веб-клиенте.

Из-за этого все способы сворачивания окна делятся на две группы. Первая — обращение к средствам Windows (COM-объекты, WinAPI, внешние компоненты), что работает только под Windows и только на клиенте. Вторая — приёмы, имитирующие результат: активизация другого окна или приложения, после которой окно 1С визуально уходит на второй план.

Способ 1. Отправка клавиш через WScript.Shell

Самый простой вариант без установки дополнительных компонентов — использовать COM-объект WScript.Shell, который доступен в Windows по умолчанию. Через метод SendKeys можно отправить системное сочетание клавиш, сворачивающее окна.

Сочетание Win+M сворачивает все окна, Win+Down — сворачивает активное окно (при повторном нажатии сначала восстанавливает из развёрнутого состояния, поэтому поведение зависит от текущего состояния окна). Пример кода:

Shell = Новый COMОбъект("WScript.Shell");
Shell.SendKeys("^({ESC})"); // пример отправки сочетания
// Для эмуляции клавиши Win стандартный SendKeys не подходит —
// используется AppActivate на другое окно или внешние средства

Важное ограничение: стандартный SendKeys не умеет нажимать клавишу Windows (Win). Поэтому на практике этот объект чаще используют для обратной задачи — активировать другое приложение методом AppActivate, после чего окно 1С уходит на задний план:

Shell = Новый COMОбъект("WScript.Shell");
Shell.AppActivate("Калькулятор"); // заголовок окна другого приложения

Способ 2. WinAPI через внешние компоненты

Полноценное сворачивание конкретного окна выполняется функцией WinAPI ShowWindow, которой передаётся дескриптор окна (hWnd) и команда SW_MINIMIZE (значение 6). Из 1С напрямую вызвать WinAPI нельзя, поэтому применяют внешние компоненты по технологии Native API или COM, например известные в сообществе разработки для работы с окнами.

Общая схема такая: компонента получает заголовок или дескриптор окна, находит его через FindWindow, затем вызывает ShowWindow с нужным параметром. Дескриптор главного окна 1С можно найти по заголовку, который обычно содержит название информационной базы.

// Логика WinAPI внутри внешней компоненты
HWND hWnd = FindWindow(NULL, L"Заголовок окна 1С");
if (hWnd != NULL) {
    ShowWindow(hWnd, SW_MINIMIZE); // SW_MINIMIZE = 6
}

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

Способ 3. Активизация другого окна как альтернатива

Часто реальная цель — не свернуть окно 1С как таковое, а дать пользователю продолжить работу в другой программе, пока 1С выполняет длительную операцию. В этом случае сворачивание можно заменить активизацией целевого окна.

Кроме AppActivate из WScript.Shell, можно программно запустить нужное приложение через КомандаСистемы() или ЗапуститьПриложение() — вновь открытое окно обычно получает фокус и перекрывает окно 1С. Если приложение уже запущено, AppActivate переключит на него фокус по заголовку окна или идентификатору процесса.

Закрытие форм внутри сеанса вместо сворачивания

Если под «свернуть окно» понимается убрать с экрана открытую форму документа или обработки, задача решается штатными средствами платформы. У управляемой формы есть метод Закрыть(), который можно вызвать из кода этой же формы или извне через описание оповещения.

&НаКлиенте
Процедура ЗавершитьОбработку(Команда)
// действия по обработке данных
Закрыть(); // закрывает текущую форму
КонецПроцедуры

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

1. 1
   В форме, которую нужно закрывать, добавьте обработчик ОбработкаОповещения с проверкой имени события
2. 2
   В обработчике при получении нужного события вызовите Закрыть()
3. 3
   В месте, откуда нужно закрыть форму, вызовите Оповестить("ЗакрытьФормуОбработки")
4. 4
   Проверьте, что форма закрывается и не остаётся в списке открытых окон

Ограничения по режимам работы и типичные ошибки

Главное ограничение всех «системных» способов — привязка к Windows и к толстому или тонкому клиенту. В веб-клиенте код выполняется в песочнице браузера и не имеет доступа ни к COM-объектам, ни к окнам ОС. На сервере (в контексте &НаСервере) управлять окнами клиентского компьютера невозможно в принципе — сервер не знает о них ничего.

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

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

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

При выборе решения исходите из среды: для разовых скриптов и регламентных запусков под Windows достаточно WScript.Shell с активизацией другого окна; для промышленной эксплуатации, где нужно именно сворачивание конкретного окна, — внешней компоненты с WinAPI; для задач внутри сеанса — штатных методов формы.

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