Função Executar

 Nota   A função, propriedade, método ou objecto descrito neste tópico está desactivado se o serviço de expressão do Microsoft Jet estiver a ser executado em modo sandbox, impedindo a avaliação de expressões potencialmente não seguro. Para mais informações sobre o modo sandbox, procure "modo sandbox" na ajuda.

Executa um programa executável e devolve uma Variante (Duplo) que representa o ID da tarefa do programa se tiver êxito, caso contrário devolve zero.

Sintaxe

Executar(nomecaminho [, estilojanela ] )

A sintaxe da função Executar tem os seguintes argumentos (argumento: valor que fornece informações a uma acção, evento, método, propriedade, função ou procedimento.):

Argumento Descrição
nomecaminho Obrigatório. Variante (Cadeia). Nome do programa a executar e quaisquer argumentos (argumento: valor que fornece informações a uma acção, evento, método, propriedade, função ou procedimento.) ou parâmetros da linha de comandos (linha de comandos: cadeia de caracteres utilizada para iniciar uma aplicação.) obrigatórios; pode incluir directório ou pasta e unidade. Na Macintosh, pode utilizar a função MacID para especificar uma assinatura da aplicação em vez do respectivo nome. O exemplo que se segue utiliza a assinatura para o Microsoft Word:
Shell MacID("MSWD")
estilojanela Opcional. Variante (Número Inteiro) correspondente ao estilo da janela na qual o programa será executado. Se estilojanela for omitido, o programa será iniciado minimizado com foco. Na Macintosh (System 7.0 ou posterior), estilojanela apenas determina se a aplicação obtém o foco quando é executada.

O argumento denominado estilojanela tem os seguintes valores:

Constante Valor Descrição
vbHide 0 A janela é oculta e o foco é introduzido na janela oculta. A constante vbHide não é aplicável nas plataformas Macintosh.
vbNormalFocus 1 Uma janela tem foco e é restaurada para o respectivo tamanho e posição originais.
vbMinimizedFocus 2 A janela é apresentada como um ícone com foco.
vbMaximizedFocus 3 A janela é maximizada com foco.
vbNormalNoFocus 4 A janela é restaurada para o respectivo tamanho e posição mais recentes. A janela actualmente activa permanece activa.
vbMinimizedNoFocus 6 A janela é apresentada como um ícone. A janela actualmente activa permanece activa.

Observações

Se a função Executar executar com êxito o ficheiro com nome, devolve o ID da tarefa do programa iniciado. O ID da tarefa é um número exclusivo que identifica o programa em execução. Se a função Executar não conseguir iniciar o programa com nome, ocorre um erro.

Na Macintosh, vbNormalFocus, vbMinimizedFocus e vbMaximizedFocus colocam a aplicação em primeiro plano; vbHide, vbNoFocus, vbMinimizeFocus colocam a aplicação em segundo plano.

 Nota    Por predefinição, a função Executar executa outros programas de modo assíncrono. Isto significa que um programa iniciado com a função Executar poderá não ser executado antes das instruções a seguir à execução da função Executar.

Exemplo

 Nota   Os exemplos que se seguem demonstram a utilização desta função num módulo do Visual Basic for Applications (VBA). Para mais informações sobre como trabalhar com VBA, seleccione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

Este exemplo utiliza a função Executar para executar uma aplicação especificada pelo utilizador. na MacIntosh, o nome da unidade predefinido é “HD” e as partes do nome do caminho são separadas por dois pontos e não por barras invertidas. Da mesma forma, pode especificar as pastas da 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)

      
 
 
Aplica-se a:
Access 2007