ExecuteExternalApp

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

Esta página foi útil?