Método IShellDispatch2.ShellExecute

Executa uma operação especificada em um arquivo especificado.

Sintaxe

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

Parâmetros

sFile [in]

Tipo: BSTR

Uma Cadeia de Caracteres que contém o nome do arquivo no qual ShellExecute executará a ação especificada pela vOperation.

vArguments [in, opcional]

Tipo: Variant

Uma cadeia de caracteres que contém valores de parâmetro para a operação.

vDirectory [in, opcional]

Tipo: Variant

O caminho totalmente qualificado do diretório que contém o arquivo especificado por sFile. Se esse parâmetro não for especificado, o diretório de trabalho atual será usado.

vOperation [in, opcional]

Tipo: Variant

A operação a ser executada. Esse valor é definido como uma das cadeias de caracteres de verbo com suporte do arquivo. Para obter uma discussão sobre verbos, consulte a seção Comentários. Se esse parâmetro não for especificado, a operação padrão será executada.

vShow [in, opcional]

Tipo: Variant

Uma recomendação sobre como a janela do aplicativo deve ser exibida inicialmente. O aplicativo pode ignorar essa recomendação. Esse parâmetro pode usar um dos valores a seguir. Se esse parâmetro não for especificado, o aplicativo usará seu valor padrão.

Valor	Significado
0	Abra o aplicativo com uma janela oculta.
1	Abra o aplicativo com uma janela normal. Se a janela for minimizada ou maximizada, o sistema a restaurará para seu tamanho e posição originais.
2	Abra o aplicativo com uma janela minimizada.
3	Abra o aplicativo com uma janela maximizada.
4	Abra o aplicativo com sua janela em seu tamanho e posição mais recentes. A janela ativa permanece ativa.
5	Abra o aplicativo com sua janela em seu tamanho e posição atuais.
7	Abra o aplicativo com uma janela minimizada. A janela ativa permanece ativa.
10	Abra o aplicativo com sua janela no estado padrão especificado pelo aplicativo.

 

Comentários

Esse método é implementado e acessado por meio do método Shell.ShellExecute .

Esse método é equivalente a iniciar um dos comandos associados ao menu de atalho de um arquivo. Cada comando é representado por uma cadeia de caracteres de verbo. O conjunto de verbos com suporte varia de arquivo para arquivo. O verbo com suporte mais comum é "open", que também geralmente é o verbo padrão. Outros verbos podem ter suporte apenas para determinados tipos de arquivos. Para obter mais discussões sobre os verbos do Shell, consulte Iniciando aplicativos ou estendendo menus de atalho.

Esse método não está disponível no momento no Microsoft Visual Basic.

Exemplos

Os exemplos a seguir mostram o uso de ShellExecute para abrir o Bloco de Notas. O uso é mostrado para JScript e 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>

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (versão 5.0 ou posterior)