|
<< Clique para Mostrar o Sumário >>
ExecuteExternalApp |
ExecuteExternalApp(AppPath, Arguments, InitialDir, CmdShow, [ProcessId])
Este método executa uma aplicação externa de nome e caminho indicado no parâmetro AppPath, com os argumentos indicados pelo parâmetro Arguments, iniciando no diretório de trabalho indicado pelo parâmetro InitialDir. Quando especificado um documento no parâmetro AppPath, a aplicação associada a este documento é executada e o documento é passado como um dos parâmetros da aplicação. O parâmetro ProcessID é opcional e recebe o número que identifica o processo da aplicação externa no sistema operacional. Este número é utilizado no método IsAppRunning e é o mesmo valor que aparece no Gerenciador de Tarefas do Windows, na coluna PID. O parâmetro CmdShow especifica o modo de abertura da janela da aplicação, conforme descrito na tabela a seguir.
Opções disponíveis para o parâmetro CmdShow
Opção |
Descrição |
|---|---|
0 |
Esconde a janela e ativa outra janela |
1 |
Ativa e mostra a janela. Se a janela estiver maximizada ou minimizada, ela é restaurada para o tamanho e posição originais. Uma aplicação deve especificar este valor quando estiver mostrando uma janela pela primeira vez |
2 |
Ativa a janela e mostra-a minimizada |
3 |
Ativa a janela e mostra-a maximizada |
4 |
Mostra a janela com seu tamanho e posição mais recentes. A janela ativa permanece ativa |
5 |
Ativa a janela e mostra-a com seu tamanho e posição atuais |
6 |
Minimiza a janela e ativa a próxima janela de nível superior |
7 |
Mostra a janela minimizada. A janela ativa permanece ativa |
8 |
Mostra a janela em seu estado atual. A janela ativa permanece ativa |
9 |
Ativa e mostra a janela. Se a janela estiver maximizada ou minimizada, ela é restaurada para o tamanho e posição originais. Uma aplicação deve especificar este valor quando estiver restaurando uma janela que estava minimizada |
O código a seguir contém um exemplo de uso deste método.
Sub CommandButton1_Click()
Dim ret
Application.ExecuteExternalApp "calc.exe", "", "", 1, ret
Application.GetObject("Dados.TagInterno1").Value = ret
End Sub
NOTA |
O parâmetro retornado em ProcessID pode ser 0 (zero), caso nenhum processo tenha sido iniciado. Por exemplo, se um documento aberto é uma URL e uma instância do Internet Explorer já está em execução, esta instância mostra o documento. Nenhum processo novo é iniciado, portanto ProcessID é 0 (zero). |