Метод IShellDispatch2.ShellExecute
Выполняет указанную операцию с указанным файлом.
Синтаксис
iRetVal = IShellDispatch2.ShellExecute(
sFile,
[ vArguments ],
[ vDirectory ],
[ vOperation ],
[ vShow ]
)
IShellDispatch2.ShellExecute( _
ByVal sFile As BSTR, _
[ ByVal vArguments As Variant ], _
[ ByVal vDirectory As Variant ], _
[ ByVal vOperation As Variant ], _
[ ByVal vShow As Variant ] _
) As Integer
Параметры
-
sFile [in]
-
Тип: BSTR
Строка, содержащая имя файла, в котором ShellExecute будет выполнять действие, заданное vOperation.
-
vArguments [in, optional]
-
Тип: Variant
Строка, содержащая значения параметров для операции.
-
vDirectory [in, optional]
-
Тип: Variant
Полный путь к каталогу, который содержит файл, указанный параметром sFile. Если этот параметр не указан, используется текущий рабочий каталог.
-
vOperation [in, необязательный]
-
Тип: Variant
Операция, которая выполняется. Этому значению присваивается одна из строк глаголов, поддерживаемых файлом. Обсуждение глаголов см. в разделе Примечания. Если этот параметр не указан, выполняется операция по умолчанию.
-
vShow [in, optional]
-
Тип: Variant
Рекомендация по первоначальному отображению окна приложения. Приложение может игнорировать эту рекомендацию. Этот параметр может принимать одно из указанных ниже значений. Если этот параметр не указан, приложение использует значение по умолчанию.
Значение Значение - 0
Откройте приложение со скрытым окном. - 1
Откройте приложение в обычном окне. Если окно свернуто или развернуто, система восстанавливает его исходный размер и положение. - 2
Откройте приложение в свернутом окне. - 3
Откройте приложение с развернутыми окнами. - 4
Откройте приложение с его окном с его последним размером и положением. Активное окно остается активным. - 5
Откройте приложение с его окном текущего размера и расположения. - 7
Откройте приложение в свернутом окне. Активное окно остается активным. - 10
Откройте приложение с его окном в состоянии по умолчанию, заданном приложением.
Комментарии
Этот метод реализуется с помощью метода Shell.ShellExecute .
Этот метод эквивалентен запуску одной из команд, связанных с контекстным меню файла. Каждая команда представлена строкой глагола. Набор поддерживаемых команд зависит от файла к файлу. Чаще всего поддерживается команда "open", которая также обычно является глаголом по умолчанию. Другие команды могут поддерживаться только определенными типами файлов. Дополнительные сведения о командах оболочки см. в разделе Запуск приложений или Расширение контекстных меню.
В настоящее время этот метод недоступен в Microsoft Visual Basic.
Примеры
В следующих примерах показано использование ShellExecute для открытия Блокнота. Использование отображается для JScript и VBScript.
Jscript:
<script language="JScript">
function fnShellExecuteJ()
{
var objShell = new ActiveXObject("shell.application");
objShell.ShellExecute("notepad.exe", "", "", "open", 1);
}
</script>
Vbscript:
<script language="VBScript">
function fnShellExecuteVB()
dim objShell
set objShell = CreateObject("shell.application")
objShell.ShellExecute "notepad.exe", "", "", "open", 1
set objShell = nothing
end function
</script>
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 2000 Professional, Windows XP [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2003 [только классические приложения] |
| Заголовок |
|
| IDL |
|
| DLL |
|