Método Shell.ShellExecute

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

Sintaxe

Jscript:

iRetVal = Shell.ShellExecute(
  sFile,
  [ vArguments ],
  [ vDirectory ],
  [ vOperation ],
  [ vShow ]
);

Vbscript:

iRetVal = Shell.ShellExecute( _
  sFile, _
  [ ByVal vArguments ], _
  [ ByVal vDirectory ], _
  [ ByVal vOperation ], _
  [ ByVal vShow ] _
)

VB:

Shell.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 String que contém o nome do arquivo no qual ShellExecute executará a ação especificada por 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 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 é 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 verbos do Shell, consulte Iniciando aplicativos ou Estendendo menus de atalho.

Este método não está disponível atualmente 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:

function ShellExecuteJS()
{
    var objShell = new ActiveXObject("Shell.Application");
    objShell.ShellExecute("notepad.exe", "", "", "open", 1);
}

Vbscript:

Function ShellExecuteVB()
    Dim objShell
    Set objShell = CreateObject("Shell.Application")
    Call objShell.ShellExecute("notepad.exe", "", "", "open", 1)
End Function

Requisitos