Документация 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 } }