O comando RUN permite executar programas, ou seja, iniciar processos, a partir de um programa OpusWin. Esses processos podem ser acionados de forma síncrona ou assíncrona.
Sintaxe
Run <expc> [WITH <params>] [<opc>] [NOWAIT] [POS(<xi>,<yi>,<xl>,<yl>)]
Onde:
<expc>
Especifica o nome do programa a ser executado, incluída a referência (absoluta ou relativa) ao percurso onde esse programa reside. Pode ser uma variável ou um literal.
<params>
Informa os parâmetros a serem passados para o programa que está sendo invocado pelo comando RUN.
<opc>
Especifica se a janela da aplicação vai ser mostrada quando a execução do programa for iniciada e de que maneira essa janela vai se apresentar. O operando <opc> poderá conter um dos seguintes valores:
|
Opção |
Descrição da opção |
|
SW_HIDE |
Esconde a janela e passa a ativação para outra janela |
|
SW_SHOWNORMAL |
Ativa e mostra uma janela. Se a janela for minimizada ou maximizada, o Windows a restaura ao seu tamanho e posição inicial. |
|
SW_NORMAL |
Igual a SW_SHOWNORMAL. Opção Default. |
|
SW_SHOWMINIMIZED |
Ativa e mostra uma janela e a exibe como um ícone. |
|
SW_SHOWMAXIMIZED |
Ativa e mostra uma janela e a mostra maximizada. |
|
SW_MAXIMIZE |
Maximiza a janela ativa. |
|
SW_SHOWNOACTIVATE |
Mostra uma janela em seu tamanho e posição mais recentes. A janela atualmente ativa permanece ativa. |
|
SW_SHOW |
Ativa uma janela e a exibe em sua posição e tamanho correntes. |
|
SW_MINIMIZE |
Minimiza a janela especificada e ativa a primeira janela na lista do sistema. |
|
SW_SHOWMINNOACTIVE |
Mostra uma janela como um ícone. A janela que está ativa no momento, permanece ativa. |
|
SW_SHOWNA |
Mostra uma janela em seu status corrente. A janela atualmente ativa permanece ativa. |
|
SW_SHOWNOACTIVATE |
Mostra uma janela em seu tamanho e posição mais recentes. A janela atualmente ativa permanece ativa. |
NOWAIT
Especifica que, uma vez iniciado o novo processo (iniciado pelo RUN) o controle é retornado imediatamente ao programa que emitiu o RUN, sem esperar (NOWAIT) a conclusão desse novo processo. Por padrão, o comando RUN inicia um processo de maneira síncrona, ou seja, o controle retorna ao programa chamador após terminado o programa chamado.
POS(<xi>,<yi>,<xl>,<yl>)
Especifica as coordenadas da janela a ser exibida pelo programa informado em <expc>.