Shell.Execute

number Shell.Execute (

string Filename,
string Verb = "open",
string Arguments = "",
string WorkingFolder = "",
number WindowMode = SW_SHOWNORMAL,
boolean WaitForReturn = false )

Примеры

Описание

Запускает работу оболочки на целевом файле с данным глаголом оболочки.

Параметры

Filename

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

Verb

(строка) Глагол, используемый в командной оболочке. Выбор из:

ГЛАГОЛ VERB	ОПИСАНИЕ DESCRIPTION
open	Открывает файл. Это тоже самое, что делается после двойного клика по файлу в Windows.
explore	Открывает файл/папку в Проводнике Windows.
edit	Открывает файл для редактирования, используя связанный с ним (ассоциированный) редактор.
print	Использует связанный с ним (ассоциированный) вьювер для печати файла.

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

Arguments

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

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 для определения случился ли отказ в работе этого действия и почему.

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

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

Примеры

Пример 1

-- Gets the path to the user's My Documents folder
-- Получаем путь к папке пользователя Мои документы
MyDocs = Shell.GetFolder(SHF_MYDOCUMENTS);

Shell.Execute(MyDocs .. "\\CompanyInfo.htm", "edit", "", "", SW_SHOWNORMAL);

В первой строке используется действие Shell.GetFolder для получения пути к пользовательской папке Мои документы и сохранения его в переменной "MyDocs". Затем файл "CompanyInfo.htm" открывается используя глагол "edit" в действии Shell.Execute. Файл будет открыт пользовательским ассоциированным редактором для файлов .htm.

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