Função: ShellExecute
Executa um arquivo.
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)
// 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
- Função válida somente para sistemas operacionais Microsoft Windows, e a partir da varsão XP.
- 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, so 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
Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server
Visão Geral
Import HTML Content
Conteúdo das Ferramentas