Class: OSApplication

Members

---

<static> HIDE

Constante para ser usada no parâmetro 'commandShow' do método start(parameters, commandShow). Esta constante indica que a janela da aplicação ficará oculta quando a aplicação estiver sendo executada.

---

<static> INFINITE_TIMEOUT

Constante para ser usada no parâmetro 'timeout' do método waitFor(timeout). Se esta constante for informada, a execução da próxima instrução, que vem logo após a chamada do método waitFor(timeout), só irá ocorrer quando a a aplicação for finalizada.

---

<static> MAXIMIZE

Constante para ser usada no parâmetro 'commandShow' do método start(parameters, commandShow). Esta constante indica que a janela da aplicação será aberta de forma maximizada quando a aplicação for executada.

---

<static> MINIMIZE

Constante para ser usada no parâmetro 'commandShow' do método start(parameters, commandShow). Esta constante indica que a janela da aplicação será aberta de forma minimizada quando a aplicação for executada.

---

<static> SHOW

Constante para ser usada no parâmetro 'commandShow' do método start(parameters, commandShow). Esta constante indica que a janela da aplicação será exibida.

---

workingDirectory

Caminho do diretório de trabalho da aplicação.

Methods

---

<static> startDetached(command, parameters, workingDirectory)

Executa a aplicação de forma assíncrona. Usando o método estático a aplicação não depende da instância de OSApplication, sendo preferível este uso. Em caso de falha, o valor de retorno será 'undefined'.

Parameters:

Name	Type	Description
command	string	Caminho do executável. Caso o executável esteja no PATH do sistema não é necessário informar o caminho completo.
parameters	string	Parâmetros usados para executar a aplicação. Informe de maneira semelhante ao chamar via prompt do DOS, usando "(aspas) para parâmetros com espaço.
workingDirectory	string	Caminho do diretório de trabalho da aplicação.

See:

• OSApplication#startDetached

Returns:

Número identificador do processo.

Type

number

---

getExitCode()

Obtém o código de erro retornado pela aplicação ao ser finalizada. Caso a aplicação esteja em execução ou nunca foi executada será retornado 'undefined'.

Returns:

código de erro retornado pela aplicação.

Type

number

---

getIsRunning()

Indica se a aplicação está sendo executada.

Returns:

Retorna "true" para indicar que a aplicação está em execução, retorna "false", caso contrário.

Type

boolean

---

getLastErrorCode()

Caso haja algum erro na execução da aplicação, o valor dessa propriedade será o código do último erro ocorrido. Caso a aplicação esteja em execução ou nunca foi executada, o valor retornado será '0'.

Returns:

código de erro retornado pela aplicação.

Type

number

---

getPid()

Identificador do processo. Caso a aplicação não esteja sendo executada o valor desta propriedade será 'undefined'.

Returns:

Número identificador do processo.

Type

number

---

redirectStdErrorOutput(outputErrorFileName)

Redireciona a saída padrão de erros da aplicação em execução para arquivos.

Parameters:

Name	Type	Description
outputErrorFileName	string	Nome do arquivo que será utilizado como saída padrão de erro da aplicação.

---

redirectStdInput(inputFileName)

Redireciona a entrada padrão da aplicação em execução para arquivos. Seria o equivalente ao executar: programa.exe < entrada.txt

Parameters:

Name	Type	Description
inputFileName	string	Nome do arquivo que será utilizado como entrada padrão para a aplicação.

---

redirectStdOutput(outputFileName)

Redireciona a saída padrão da aplicação em execução para arquivos. Seria o equivalente ao executar: programa.exe > saída.txt

Parameters:

Name	Type	Description
outputFileName	string	Nome do arquivo que será utilizado como saída padrão para a aplicação.

---

start(parameters, commandShow)

Executa a aplicação de forma assíncrona. A aplicação será finalizada se não houver mais referências a esta instância de OSApplication ou se a sessão do usuário for finalizada. Utilize o método #waitFor se desejar aguardar a conclusão da execução da aplicação.

Parameters:

Name	Type	Description
parameters	string	Parâmetros usados para executar a aplicação. Informe de maneira semelhante ao chamar via prompt do DOS, usando "(aspas) para parâmetros com espaço.
commandShow	string	Indica a forma de como a janela a aplicação será mostrada ao ser executada. Os possíveis valores são: OSApplication.SHOW, OSApplication.HIDE, OSApplication.MINIMIZE e OSApplication.MAXIMIZE.

See:

• #startDetached

Returns:

Retorna "true", caso a execução da aplicação for bem sucedida. Retorna "false", caso contrário.

Type

boolean

---

startDetached()

A criação de um processo desatachado não é mais suportado por este método, sendo o comportamento atual equivalente a chamar o método #start. Utilize OSApplication.startDetached caso necessite criar um processo desatachado.

Deprecated:

• Utilize o método estático OSApplication.startDetached.

See:

• #start

---

terminate( [opt_timeout])

Finaliza a execução da aplicação.

Parameters:

Name	Type	Argument	Description
opt_timeout	number	<optional>	Tempo limite para a aplicação ser finalizada. Ao finalizar uma aplicação, ela precisa liberar os recursos que ela aloca. Ao executar o este método é dado um tempo máximo para aplicação liberar os recursos, caso o tempo máximo seja excedido a aplicação será fechada de forma forçada. O valor default do tempo máximo para fechamento da aplicação é 10segundos. O valor informado para o parâmetro timeout deve ser informado em milissegundos.

Returns:

Retorna "true", caso a aplicação seja finalizada dentro do tempo limite especificado. Retorna "false", caso contrário.

Type

boolean

---

waitFor( [opt_timeout])

Aguarda a aplicação ser finalizada. Ao chamar este método, o próximo comando não é executado até que a aplicação seja fechada ou exceda o tempo máximo de espera informado.

Parameters:

Name	Type	Argument	Description
opt_timeout	number	<optional>	Tempo máximo de espera para que a aplicação seja fechada. Se a constante OSApplication.INFINITE_TIMEOUT for informada para este parâmetro ou este parâmetro for omitido, o método waitFor irá esperar que aplicação seja fechada.

Returns:

Retorna "true", caso a aplicação seja fechada dentro do tempo limite especificado. Retorna "false", caso contrário.

Type

boolean