Descrição
WaitRun [AS] - Executa um programa externo (arquivo executável) através do sistema operacional da estação onde o Smart Client está sendo executado, e aguarda pelo término do programa externo.
|
Sintaxe
| WaitRun( <cExeName>, <nOpc> ) |
Parâmetros
| Par |
Nome |
Tipo |
Descrição |
Default |
Obg |
Ref |
01
|
cExeName |
Caracter |
Indica o nome e extensão do arquivo executável |
|
|
|
| 02 |
nOpc |
Numérico |
Indica o modo de interface a ser criado para a execução do programa. Para mais informações sobre as opções disponíveis, consulte a área de Observações |
|
|
|
Retorno
| Retorno |
Tipo |
Descrição |
| nRet |
Numérico
|
Retorna o status da execução do processo
|
Exemplo
#INCLUDE "TOTVS.CH"
#DEFINE SW_HIDE 0 // Escondido
#DEFINE SW_SHOWNORMAL 1 // Normal
#DEFINE SW_NORMAL 1 // Normal
#DEFINE SW_SHOWMINIMIZED 2 // Minimizada
#DEFINE SW_SHOWMAXIMIZED 3 // Maximizada
#DEFINE SW_MAXIMIZE 3 // Maximizada
#DEFINE SW_SHOWNOACTIVATE 4 // Na Ativação
#DEFINE SW_SHOW 5 // Mostra na posição mais recente da janela
#DEFINE SW_MINIMIZE 6 // Minimizada
#DEFINE SW_SHOWMINNOACTIVE 7 // Minimizada
#DEFINE SW_SHOWNA 8 // Esconde a barra de tarefas
#DEFINE SW_RESTORE 9 // Restaura a posição anterior
#DEFINE SW_SHOWDEFAULT 10// Posição padrão da aplicação
#DEFINE SW_FORCEMINIMIZE 11// Força minimização independente da aplicação executada
#DEFINE SW_MAX 11// Maximizada
User Function WaitRun()
WaitRun( "CALC.EXE", SW_SHOWNORMAL )
Return( Nil )
Resultado
Informações adicionais
|
A função WaitRun() deve ser chamada de um programa AdvPL que está sendo executado a partir de uma conexão do Smart Client. Caso a função seja chamada a partir de um processo que não foi iniciado a partir do Smart Client, por exemplo uma função em JOB, a função não executará o programa e retornará -1.
O status de retorno em caso de sucesso na chamada do aplicativo externo será 0 (zero) e, em caso de falha na localização ou inexistência do arquivo executável, será retornado status 2.
A seguir, veja a tabela de opções de exibição da janela da aplicação executada. Estas constantes podem ser usadas em programas AdvPL, desde que o programa implemente o uso do #include "shell.ch"
|
Gostou? Compartilhe com seus amigos e deixe um comentário! 😎
