EXECCONSOLEAPP — различия между версиями

Материал из GB wiki
Перейти к: навигация, поиск
Строка 3: Строка 3:
 
|Описание=Выполняет внешнее приложение. Возвращает код завершения приложения, помещает его текстовый вывод в переменную :AppStdOut
 
|Описание=Выполняет внешнее приложение. Возвращает код завершения приложения, помещает его текстовый вывод в переменную :AppStdOut
 
|Синтаксис=Вариант 1 - выполнение операции над указанным файлом, используя приложение по умолчанию<br/>
 
|Синтаксис=Вариант 1 - выполнение операции над указанным файлом, используя приложение по умолчанию<br/>
EXECCONSOLEAPP (`shellexecute`,'''Операция''','''Файл''','''Параметры''','''Путь к файлу''','''Вид окна''')<br/>
+
EXECCONSOLEAPP (`shellexecute`,'''Операция''','''Файл''','''Параметры''','''Путь к файлу''',Вид окна)<br/>
 
либо (упрощенный вариант)<br/>
 
либо (упрощенный вариант)<br/>
 
EXECCONSOLEAPP (`start`,'''Файл''',Режим)<br/>
 
EXECCONSOLEAPP (`start`,'''Файл''',Режим)<br/>
Строка 32: Строка 32:
 
{{Аргумент
 
{{Аргумент
 
  |Название=Вид окна
 
  |Название=Вид окна
  |Пояснение=Вид окна приложения:
+
  |Пояснение=Вид окна приложения (необязательный параметр):
*0 - Скрывает окно загружаемого приложения и активизирует другое окно.  
+
*0 (`SW_HIDE`) - Скрывает окно загружаемого приложения и активизирует другое окно.  
*1 - Отображает главное окно приложения и делает его активным. Если окно приложения минимизировано или максимизировано, Windows восстанавливает его первоначальный размер и позицию.  
+
*1 (`SW_SHOWNORMAL`) - Отображает главное окно приложения и делает его активным. Если окно приложения минимизировано или максимизировано, Windows восстанавливает его первоначальный размер и позицию.  
*2 - Окно загружаемого приложения минимизировано.  
+
*2 (`SW_SHOWMINIMIZED`) - Окно загружаемого приложения минимизировано.  
*3 - Раскрывает окно приложения на весь экран и делает его активным.   
+
*3 (`SW_MAXIMIZE`) - Раскрывает окно приложения на весь экран и делает его активным.   
*4 - Отображает окно приложения в его последних сохранённых размерах, но не делает его активным.  
+
*4 (`SW_SHOWNOACTIVATE`)- Отображает окно приложения в его последних сохранённых размерах, но не делает его активным.  
 
}}<br/>
 
}}<br/>
 
{{Аргумент
 
{{Аргумент

Версия 08:09, 21 октября 2015

Выполняет внешнее приложение. Возвращает код завершения приложения, помещает его текстовый вывод в переменную :AppStdOut

Синтаксис

Вариант 1 - выполнение операции над указанным файлом, используя приложение по умолчанию
EXECCONSOLEAPP (`shellexecute`,Операция,Файл,Параметры,Путь к файлу,Вид окна)
либо (упрощенный вариант)
EXECCONSOLEAPP (`start`,Файл,Режим)
Вариант 2 – запуск консольного приложения
EXECCONSOLEAPP (Командная строка,Режим ожидания)

Аргументы

Операция
Одна из операций Windows, варианты:
  • `find` – стандартный поиск Windows (файлов, папок, компьютеров и т.д.). Файл - путь к папке, начиная с которой выполняется поиск, остальные параметры не используются.
  • `explore` – стандартный проводник Windows. Файл - путь к папке, на которой открывается проводник, остальные параметры не используются.
  • `edit` – редактирование файла в приложении по умолчанию
  • `open` – открытие файла в приложении по умолчанию
  • `print`,`printto` – печать файла из приложения по умолчанию
Файл
Имя файла, с которым следует выполнить операцию.
Параметры
Список параметров, передаваемых загружаемому приложению. Например, для операции printto параметром может быть имя принтера
Путь к файлу
Путь к файлу, указанному в параметре Файл. Если Файл уже содержит путь, то Путь=пустая строка
Вид окна
Вид окна приложения (необязательный параметр):
  • 0 (`SW_HIDE`) - Скрывает окно загружаемого приложения и активизирует другое окно.
  • 1 (`SW_SHOWNORMAL`) - Отображает главное окно приложения и делает его активным. Если окно приложения минимизировано или максимизировано, Windows восстанавливает его первоначальный размер и позицию.
  • 2 (`SW_SHOWMINIMIZED`) - Окно загружаемого приложения минимизировано.
  • 3 (`SW_MAXIMIZE`) - Раскрывает окно приложения на весь экран и делает его активным.
  • 4 (`SW_SHOWNOACTIVATE`)- Отображает окно приложения в его последних сохранённых размерах, но не делает его активным.
Командная строка
строка, полный или относительный путь к исполняемому файлу, а также аргументы командной строки (ключи). Для вызова команд ОС нужно использовать синтаксис «cmd команда».
Режим
строка, режим запуска Windows-приложения для функции ShellExecute:
  • `open` – открытие документа
  • `print` – печать документа.
Режим ожидания
целое число:
  • 0 – с ожиданием. Никакие формы ГБ недоступны до окончания работы внешней программы.
  • 1 – условное ожидание. Форма, с которой произведен вызов, становится недоступной, но можно работать в других. По окончании работы внешней программы недоступная форма становится вновь доступной.
  • 2 – без ожидания.

Тип результата

Целое число

Примеры

EXECCONSOLEAPP(`start`,`notepad`)
EXECCONSOLEAPP(`cmd /c del c:\temp\*.txt`,2)