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

parameters

sFile [in]

类型: BSTR

一个 字符串 ,包含 ShellExecute 将对其执行 vOperation 指定的操作的文件的名称。

vArguments [in, optional]

类型: Variant

包含操作的参数值的字符串。

vDirectory [in, 可选]

类型: Variant

包含 sFile 指定的文件的目录的完全限定路径。 如果未指定此参数,则使用当前工作目录。

vOperation [in, optional]

类型: Variant

要执行的操作。 此值设置为 文件支持的谓词字符串之一。 有关谓词的讨论,请参阅备注部分。 如果未指定此参数,则执行默认操作。

vShow [in, 可选]

类型: Variant

有关如何最初显示应用程序窗口的建议。 应用程序可以忽略此建议。 此参数的取值可为下列值之一: 如果未指定此参数,应用程序将使用其默认值。

含义
0
使用隐藏窗口打开应用程序。
1
使用普通窗口打开应用程序。 如果窗口最小化或最大化,系统会将其还原到其原始大小和位置。
2
使用最小化窗口打开应用程序。
3
使用最大化窗口打开应用程序。
4
打开应用程序,其窗口位于其最新大小和位置。 活动窗口保持活动状态。
5
打开应用程序,其窗口位于其当前大小和位置。
7
使用最小化窗口打开应用程序。 活动窗口保持活动状态。
10
打开应用程序,其窗口处于应用程序指定的默认状态。

 

备注

此方法通过 Shell.ShellExecute 方法实现和访问。

此方法等效于启动与文件的快捷菜单关联的命令之一。 每个命令都由谓词字符串表示。 支持的谓词集因文件而异。 最常支持的谓词是“open”,它通常也是默认谓词。 其他谓词可能仅受某些类型的文件支持。 有关 Shell 谓词的进一步讨论,请参阅 启动应用程序扩展快捷菜单

此方法目前在 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 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
标头
Shldisp.h
IDL
Shldisp.idl
DLL
Shell32.dll (5.0 或更高版本)