Criar macros

Utilize estas etapas para criar macros usando o Gerenciador de macros.

No Revit, todas as macros no nível do aplicativo usam a palavra-chave Aplicativo para endereçar o objeto do aplicativo em C#, VB.NET e Python. Isto inclui todos os dados e configurações no âmbito do aplicativo.

Em macros no nível do documento específicas do Revit, a palavra-chave Documento em C#, VB.NET e Python retorna o objeto Documento da API. Se precisar acessar o objeto Aplicativo de uma macro no nível de documento, use:

Documento.Aplicativo

Nota: Se o aplicativo ou o documento atual já contêm módulos, as macros precisam estar ativadas nas configurações de Segurança de macro.

Visão geral de criação de macros

1. No Gerenciador de macros, selecione a guia Aplicativo (para macros no nível de aplicativo) ou a guia Projeto (para macros no nível do documento) onde a macro será colocada.
2. Na seção Criar da caixa de diálogo Gerenciador de macros, clique em Macro.

   A caixa de diálogo Criar nova macro é aberta.

3. Insira as seguintes informações:
   • Insira um nome no campo Nome da macro.
   • Selecione o módulo principal na lista Macros. A linguagem do módulo principal irá definir a linguagem da macro.
   • Opcionalmente. adicione uma breve descrição da macro no campo Descrição.
   
4. Clique em OK.

   A nova macro é colocada no módulo principal no Gerenciador de macros.

   

   O aplicativo IDE de macro do Revit é iniciado para escrever as macros. Ele exibe um modelo inicial para as macros em uma linguagem de programação específica.

   Por exemplo, em um modelo C# para macros no nível de aplicativo, o IDE de macros do Revit já tem:

   • Incluído o necessário utilizando diretivas.
   • Identificado o espaço do nome do módulo (MacroAppCS no gráfico acima).
   • Iniciou a definição de classe ThisApplication.
   • Iniciou os métodos para Module_Startup() e Module_Shutdown().
   • Iniciou o seu novo método de macro ( MyFirstMacrosApp no gráfico acima), dando-lhe a oportunidade de adicionar o seu código de implementação entre parênteses.

   Além disso, observe que o Explorador de projetos do IDE de macros do Revit exibe seu contexto.

   
5. Na janela principal do IDE, agora é possível inserir seu código fonte.
6. Clique em ArquivoSalvar <nome da macro>, e a seguir feche o IDE de macros do Revit.
7. Repita as etapas de 1 a 6 para quaisquer macros adicionais necessários ao módulo.
   Nota: Lembre-se de que é preciso compilar e salvar com êxito os projetos de módulos no IDE de macros do Revit, antes que eles sejam exibidos na lista categorizada do Gerenciador de macros.

   Ferramentas opcionais

   • Clique em Descrição para ver uma descrição de um módulo ou macro selecionado em sua totalidade. Isto é útil quando a coluna Descrição do Gerenciador de macros está truncada.