File.Run

number File.Run (

string Filename,
string Args = "",
string WorkingFolder = "",
number WindowMode = SW_SHOWNORMAL,
boolean WaitForReturn = false )

Примеры

Описание

Запускает исполняемый файл.

Примечание: Если проект распространяется на Windows Vista или более поздней системе и используется запрошенный уровень выполнения другой, нежели чем "Требуется администратор", взамен следует использовать действие Shell.Execute.

Параметры

Filename

(строка) Путь к исполняемому (.exe) файлу.

Args

(строка) Аргументы командной строки для передачи исполняемому файлу.

WorkingFolder

(строка) Рабочая папка устанавливаемая для исполняемого файла.

Примечание: Этот параметр устанавливает текущую рабочую папку какой-то другой, чем папка в которой находится файл. Как правило, его оставляют пустым.

WindowMode

(число) Используемый режим (вид) окна:

КОНСТАНТА CONSTANT	ЗНАЧЕНИЕ VALUE	ОПИСАНИЕ DESCRIPTION
SW_SHOWNORMAL	1	Обычный. (По умолчанию)
SW_MAXIMIZE	3	Развернутый.
SW_MINIMIZE	6	Свернутый.
SW_HIDE	0	Скрытый.

WaitForReturn

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

ЗНАЧЕНИЕ VALUE	ОПИСАНИЕ DESCRIPTION
true	Ждать.
false	Не ждать. (По умолчанию)

Возврат

(число) Процесс возвращает код если параметр WaitForReturn установлен как истина (true). Если параметр WaitForReturn установлен как ложь (false), возвращается 0. Можно использовать Application.GetLastError для определения случился ли отказ в работе этого действия и почему.

Примечание: В системе Windows Vista или более поздней, если это действие заканчивается неудачей из-за требующегося повышения прав, будет возвращена ошибка с кодом 1045.

Примечание: Если указанный процесс не заканчивается, состояние завершения возвращает STILL_ACTIVE. Если процесс закончился, состояние завершения может возвратить одно из следующих значений:
    Значение выхода указанное в функции ExitProcess или TerminateProcess.
    Значение возврата из основной функции или функции WinMain процесса.
    Исключительное значение для необработанного исключения, вызвавшего окончание процесса.

Смотрите также: Связанные действия

Примеры

Пример 1

File.Run("AutoPlay\\Docs\\setup.exe", "/w", "", SW_MAXIMIZE, true);

Запускаем файл "AutoPlay\Docs\setup.exe", передаем ему /w как аргумент командной строки, указываем ему развернуть окно и ждем когда setup.exe закончит, для продолжения работы с новым действием.

Пример 2

File.Run("notepad.exe", "AutoPlay\\Docs\\readme.txt", "C:\\Temp", SW_SHOWNORMAL, true);

Запускаем notepad.exe (Блокнот) и открываем "AutoPlay\Docs\readme.txt" в нем. Указываем папку C:\Temp как рабочую директорию, говорим блокноту открыться в окне обычного размера и положения и ждем, когда пользователь закроет notepad.exe, чтобы продолжить работу.

Пример 3

-- Confirm that the installation executable should be launched.
-- Запрашиваем подтверждение запуска исполняемого файла установки.
result = Dialog.Message("Confirm", "Are you sure you would like to install now?", MB_YESNO, MB_ICONINFORMATION, MB_DEFBUTTON1);

-- If the user clicked the Yes button.
-- Если пользователь кликнул кнопку Yes.
if (result == IDYES) then

    -- Run the installation file.
    -- Запускаем файл установки.
    File.Run("AutoPlay\\Docs\\setup.exe", "", "", SW_SHOWNORMAL, false);

    -- Check to see if an error occurred when launching the file.
    -- Проверяем, не было ли ошибки при запуске файла.
    error = Application.GetLastError();

    -- If an error occurred, display an error message to the user.
    -- Если случается ошибка, показываем пользователю сообщение об ошибке.
    if (error ~= 0) then
        Dialog.Message("Error", _tblErrorMessages[error], MB_OK, MB_ICONEXCLAMATION, MB_DEFBUTTON1);
    end
end

Спрашиваем пользователя, хочет ли он запустить установочный файл. Если он кликает кнопку Yes (Да), установочный файл будет запущен при помощи действия File.Run. Если действие закончится неудачей, показываем диалоговое окно сообщения с кодом ошибки.

Смотрите также: Связанные действия