_o_AP ShellExecute

4D Pack v15 R2

_o_AP ShellExecute


_o_AP ShellExecute ( nomeArquivo ; modo ; param ) -> Resultado

Parâmetro	Tipo	Descrição
nomeArquivo	String	Nome do arquivo ou do documento a executar
modo	Inteiro longo	Estado da janela ao abrir
param	Texto	Parâmetros da aplicação
Resultado	Inteiro longo	0, se a execução do comando é correta; caso contrário código de erro

Descrição

Nota de compatibilidade: Este comando é obsoleto, somente se conserva por razões de compatibilidade e será eliminado em futuras versões do plug-in. Se recomenda usar o comando LAUNCH EXTERNAL PROCESS de 4D. Leve em conta que desde a versão 11.0 de 4D, AP ShellExecute só funciona em Windows.

Nota: Este comando só funciona em Windows. Em Mac OS, não tem nenhum efeito.

O comando _o_AP ShellExecute permite lançar uma aplicação ou abrir um documento desde uma base 4D.

No parâmetro nomeArquivo, passe o nome ou via de acesso completa (absoluta) do arquivo a lançar. Quando a aplicação ou documento a abrir se encontra junto a estrutura da base, é possível passar só o nome de arquivo ou uma via de acesso relativa.
Só tem que indicar o nome do documento e Windows se encarrega da execução da aplicação associada.

O parâmetro modo permite especificar o modo de visualização da janela na que será lançada a aplicação:

Se passar 0, a janela aparecerá normal;
Se passar 1, a janela aparecerá na tela completa;
Se passar 2, a janela será reduzida e aparecerá na barra de tarefas de Windows.

O parâmetro param permite passar todo tipo de parâmetro adicional que possa ser necessário para a aplicação executada. Por exemplo, se utiliza este comando para lançar um navegador web, pode passar um URL específico neste parâmetro.

Exemplo 1

Este exemplo abre um documento de tipo Word® localizado na raiz do disco principal:

  `Em Windows

 $err:=_o_AP ShellExecute("C:\Test.doc")

4D Pack v15 R2

_o_AP ShellExecute