↑  ←  Описание функции


ShellExecute

Запуск внешней программы с помощью ShellExecute API.

ShellExecute ( "filename" [, "parameters" [, "workingdir" [, "verb" [, showflag ]]]] )

Параметры

filename Имя или путь запускаемого файла (EXE, .txt, .lnk, и т.д.).
parameters [необязательный] Любые параметры запуска программы. Оставьте пустым ("") чтобы не использовать.
workingdir [необязательный] Рабочий каталог. Оставьте пустым ("") чтобы использовать текущий рабочий каталог.
verb [необязательный] Действие с файлом определяемое пунктом в реестре, может быть одним из следующих:
"open" = Открывает указанный файл. Файл может быть исполняемый, документ или папка.
"edit" = Запускает редактор и открывает документ для редактирования. Если файл не является файлом документа, то функция не выполняется.
"print" = Печатает указанный файл документа. Если файл не является файлом документа, то функция не выполняется.
"properties" = Отображает свойства файла или папки.
Смотрите примечания для получения дополнительной информации о поведении, когда не указано действие.
showflag [необязательный] Режим отображения запускаемой программы:
@SW_HIDE = Скрыть окно (или ключ Default)
@SW_MINIMIZE = Свернуть
@SW_MAXIMIZE = Развернуть

Возвращаемое значение

Успех:Возвращает 1.
Ошибка:Возвращает 0 и устанавливает @error не равным нулю.

Примечания

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

Если действие не указано, то используется действие по умолчанию. Действие по умолчанию указывается в реестре. Если в реестре не указано действие по умолчанию, то используется действие "open" из реестра. Если действие "open" отсутствует, тогда выполняется первое действие из перечисленных в реестре (за исключением Windows 2000).

См. также

ShellExecuteWait, Run, RunWait, RunAs, RunAsWait

Пример

; Запускает блокнот
ShellExecute("notepad.exe")

Exit

; Открывает .txt файл в ассоциированном по умолчанию редакторе
ShellExecute("myfile.txt", "", @ScriptDir, "edit")

; Открывает .htm файл в браузере (тоже что "Открыть" в контекстном меню)
ShellExecute(@ScriptDir & '\Help.htm', "", @ScriptDir, "open")

; Открывает .htm файл в редакторе (тоже что "Изменить" в контекстном меню)
ShellExecute(@ScriptDir & '\Help.htm', "", @ScriptDir, "edit")

; Открывает ссылку в браузере
ShellExecute('http://www.autoitscript.com/forum/')

; Регистрация dll-файла
ShellExecute(@SystemDir & '\regsvr32.exe', '/s ' & @SystemDir & '\capicom.dll', '', '', @SW_HIDE)