Função Shell

Executa um programa executável e retorna uma Variant (Duplo) que, se bem-sucedida, representa a ID de tarefa do programa. Caso contrário, retorna zero.

Sintaxe

Shell(pathname, [ windowstyle ])

A sintaxe da função Shell tem estes argumentos nomeados:

Sair	Descrição
nomedocaminho	Obrigatório; Variant (Cadeia de caracteres). Nome do programa a ser executado e todas as opções de argumentos ou linhas de comandos. Pode incluir o diretório ou a pasta e a unidade. No Macintosh, você pode usar a função MacID para especificar uma assinatura do aplicativo em vez de seu nome. O exemplo a seguir usa a assinatura para o Microsoft Word: Shell MacID("MSWD")
windowstyle	Opcional. Variant (Número inteiro) correspondente ao estilo da janela na qual o programa deve ser executado. Se windowstyle for omitido, o programa será iniciado na forma minimizada com foco. No Macintosh (System 7.0 ou posterior), windowstyle determina apenas se o aplicativo obtém ou não o foco quando ele é executado.

O argumento nomeado windowstyle tem esses valores:

Constant	Valor	Descrição
vbHide	0	A janela fica oculta e o foco é transmitido para a janela oculta. A constante vbHide não se aplica a plataformas Macintosh.
vbNormalFocus	1	A janela tem foco e é restaurada para o tamanho e posição originais.
vbMinimizedFocus	2	A janela é exibida como um ícone com foco.
vbMaximizedFocus	3	A janela é maximizada com foco.
vbNormalNoFocus	4	A janela é restaurada para seu tamanho e posição mais recentes. A janela ativa atual permanece ativa.
vbMinimizedNoFocus	6	A janela é exibida como um ícone. A janela ativa atual permanece ativa.

Comentários

Se a função Shell executar o arquivo nomeado com êxito, ela retornará a ID da tarefa do programa iniciado. A ID da tarefa é um número exclusivo que identifica o programa em execução. Um erro ocorrerá se a função Shell não puder iniciar o programa nomeado.

No Macintosh, vbNormalFocus, vbMinimizedFocus e vbMaximizedFocus colocam o aplicativo em primeiro plano. vbHide, vbNoFocus e vbMinimizeFocus colocam o aplicativo em segundo plano.

Observação

Por padrão, a função Shell executa outros programas de forma assíncrona. Isso significa que um programa iniciado com Shell pode não concluir a execução até que as instruções após a função Shell sejam executadas. Para esperar o término de um programa, confira Determinar quando um processo em shell termina.

Exemplo

Este exemplo usa a função Shell para executar um aplicativo especificado pelo usuário. No Macintosh, o nome de unidade padrão é "HD" e partes do nome do caminho são separadas por dois pontos, em vez de barras invertidas. Da mesma forma, você deve especificar pastas do Macintosh em vez de \WINDOWS.

' Specifying 1 as the second argument opens the application in 
' normal size and gives it the focus.
Dim RetVal
RetVal = Shell("C:\WINDOWS\NOTEPAD.EXE", 1)    ' Open Notepad.

Confira também

• Funções (Visual Basic for Applications)

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.