Comando
RunMacro()
Executa uma macro VBA presente na pasta de trabalho aberta na instância Excel gerenciada.
RunMacro(nomeMacro [, parametros [, appId]])Parâmetros
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
nomeMacro | Sim | Nome da macro VBA a executar. Pode incluir o módulo: 'Modulo1.MinhasMacro' ou apenas 'MinhaMacro'. Aceita variáveis. |
parametros | Não | Parâmetros a passar para a macro VBA, separados por vírgula. Todos são passados como strings. Ex: 'valor1,valor2,valor3'. Aceita variáveis. Máximo de 30 parâmetros. |
appId | Não | Identificador da instância Excel gerenciada. |
Exemplos
// Executar macro sem parâmetros:
RunMacro('FormatarRelatorio')
// Com parâmetros:
RunMacro('ProcessarDados', '2024,Janeiro,true')
// Macro em módulo específico:
RunMacro('Modulo1.GerarGrafico')Observações
A macro deve estar presente no arquivo .xlsm (com macros habilitadas) aberto na instância. O arquivo deve estar em formato que suporta macros (.xlsm, .xlam, .xls). Parâmetros são sempre passados como string para a macro — a conversão de tipo deve ser feita dentro do VBA. Erros na macro são propagados como exceção no AthusScript.