Função: ShellExecute
Executa uma função, um arquivo ou qualquer execução em linha de comando no S.O..
ShellExecute ( < cAcao>, < cArquivo>, < cParam>, < cDirTrabalho>, < nOpc> ) --> Nil
| Nome | Tipo | Descrição | Obrigatório | Referência |
| cAcao | Caracter | Indica o nome da ação que será executada. | X | |
| cArquivo | Caracter | Indica o caminho/diretório do arquivo que será executado. | X | |
| cParam | Caracter | Indica o parâmetro de linha que será repassado para o executável. | X | |
| cDirTrabalho | Caracter | Indica o diretório de trabalho onde o arquivo será executa. | X | |
| nOpc | Numérico | Indica a opção que será executada. Para informações das opções disponíveis, consulte a área de Observações. | X |
Nil (Nulo)
Observações
// 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
Importante
- 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 )
Nota
- 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 )
Exemplo
user function exemplo()
shellExecute("Open", "C:\Windows\System32\cmd.exe", " /k dir", "C:\", 1 )
return
TOTVS Application Server
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas