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.):
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 procura.
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)