Função Shell

Observação: Desejamos fornecer o conteúdo da Ajuda mais recente no seu idioma da forma mais rápida possível. Esta página foi traduzida de forma automatizada e pode conter imprecisões ou erros gramaticais. Nosso objetivo é que este conteúdo seja útil para você. As informações foram úteis? Dê sua opinião no final desta página. Aqui está o artigo em inglês para facilitar a referência.

Observação: A função, método, objeto ou propriedade descrito neste tópico será desabilitada se o Microsoft Jet Expression Service está em execução no modo de área restrita, o que impede a avaliação das expressões possivelmente não seguras. Para obter mais informações sobre o modo seguro, procure por "modo seguro" na Ajuda.

Executa um programa executável e retorna uma variante (duplo) que representa a ID da tarefa do programa se bem-sucedida, que caso contrário, ela retorna zero.

Sintaxe

Shell ( caminho [, windowstyle ] )

A sintaxe da função Shell possui os seguintes argumentos:

Argumento

Descrição

nome do caminho

Necessário. Variant (Cadeia). Nome do programa a ser executado e qualquer obrigatório argumentos ou opções de linha de comando; pode incluir diretório ou pasta e 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 do Microsoft Word: Shell MacID("MSWD")

WindowStyle

Opcional. Variant (Inteiro) correspondente ao estilo da janela em que o programa for executado. Se windowstyle for omitido, o programa será iniciado minimizado e com foco. No Macintosh (System 7.0 ou posterior), windowstyle somente determina se ou não o aplicativo obtém o foco quando ele é executado.


Windowstyle argumento nomeado tem estes valores:

Constante

Valor

Descrição

vbHide

0

Janela está oculta e o foco é passado para a janela oculta. A constante vbHide não é aplicável para as plataformas Macintosh.

vbNormalFocus

1

Janela tem foco e é restaurada ao seu tamanho e posição original.

vbMinimizedFocus

2

Janela é exibida como um ícone com foco.

vbMaximizedFocus

3

Janela está maximizada com foco.

vbNormalNoFocus

4

Janela é restaurada ao seu tamanho e posição mais recentes. A janela ativa no momento permanece ativa.

vbMinimizedNoFocus

6

Janela é exibida como um ícone. A janela ativa no momento permanece ativa.


Comentários

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

No Macintosh, vbNormalFocus, vbMinimizedFocuse vbMaximizedFocus colocam o aplicativo em primeiro plano; vbHide, vbNoFocusvbMinimizeFocus todos os coloque 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 não pode concluir a execução antes que as declarações seguindo a função Shell sejam executadas.

Exemplo

Observação: Exemplos a seguir demonstram o uso dessa função em um Visual Basic para módulo Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione a Referência do desenvolvedor na lista suspensa ao lado de pesquisa e insira um ou mais termos na caixa de pesquisa.

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 caminho são separados por vírgulas em vez de barras invertidas. Da mesma forma, especifique as pastas de Macintosh em vez de \Windows.

' Specifying 1 as the second argument 
' opens the application in normal size and
' gives it the focus.
Dim RetVal
' Run Calculator.
RetVal = Shell("C:\WINDOWS\CALC.EXE", 1)
Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×