Документация 0.4 Справочник действий

Закрыть приложение

app.close · Windows

Закрывает главные окна приложения или завершает его процесс

Закрывает программу по имени процесса: сначала вежливо — как кнопкой закрытия главного окна, — или сразу завершает процесс. Ставьте в конце процесса и в ветку „Finally“ у control.tryCatch, чтобы следующий запуск начинался с чистого экрана.

Свойства #

Свойство Имя в файле Значение Обязательное По умолчанию Описание
Имя процесса processName текст да — Без .exe, напр. notepad
Принудительно force да/нет нет нет Завершить процесс сразу (несохранённые данные будут потеряны)

Результат #

Действие не возвращает значений.

Как работает #

  • Имя процесса (processName) — имя файла программы без .exe (notepad, 1cv8, Tulpar.TestApp); .exe можно оставить — оно отбрасывается. Закрываются все процессы с этим именем.
  • Принудительно (force):
    • выключено — главным окнам отправляется команда закрытия, шаг ждёт до 5 с, пока процессы завершатся;
    • включено — процессы завершаются сразу, несохранённые данные теряются.
  • Программа не запущена — не ошибка: в лог пишется, что закрывать нечего.

Ошибки #

Код Причина и что делать
Timeout Программа не закрылась за 5 с — обычно она ждёт ответа в диалоге („Сохранить изменения?“). Закройте диалог шагами процесса или включите Принудительно
InvalidArgument Не указано имя процесса или Windows не дал завершить процесс (нет прав)

Пример #

{ "type": "app.close", "props": { "processName": "Tulpar.TestApp", "force": false } }