import.css=/download/attachments/6062824/tecnologia.css

Função: ShellExecute

Executa uma função, um arquivo ou qualquer execução em linha de comando no S.O..

 

Sintaxe

ShellExecute ( < cAcao>, < cArquivo>, < cParam>, < cDirTrabalho>, < nOpc> ) --> Nil

Parâmetros/Elementos

 

NomeTipoDescriçãoObrigatórioReferência
cAcaoCaracterIndica o nome da ação que será executada.X 
cArquivoCaracterIndica o caminho/diretório do arquivo que será executado.X 
cParamCaracterIndica o parâmetro de linha que será repassado para o executável.X 
cDirTrabalhoCaracterIndica o diretório de trabalho onde o arquivo será executa.X 
nOpcNuméricoIndica a opção que será executada. Para informações das opções disponíveis, consulte a área de Observações.X 

 

Retorno
Nil (Nulo)

 

// Tabela de opções de exibição da janela da aplicação executada
#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

 

 

  • A função somente será executada caso o client (SmartClient) esteja executando em sistemas operacionais Microsoft Windows (a partir da versão XP), ou em caso de SmartClient HTML ou SmartClient Activex.
  • Existe suporte a variáveis de ambiente nos parâmetros cArquivo e cDirTrabalho em builds superiores a 7.00.111010P.

    Exemplo: ShellExecute( "Open", "%PROGRAMFILES%\Internet Explorer\iexplore.exe", "http://www.google.com.br", "C:\", 1 )
  • Quando executada via SmartClient HTML, a função ShellExecute não tem acesso ao arquivos locais, só podendo ser utilizada para abrir URL de sites em outras janelas/abas.

    Exemplo: ShellExecute( "Open", "http://www.google.com.br", "", "C:\", 1 )
user function exemplo()
 
	shellExecute("Open", "C:\Windows\System32\cmd.exe", " /k dir", "C:\", 1 )
 
return

 

 

Abrangência
TOTVS Application Server