Criando macros

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

No Revit, a macros específicas a nível do documento, a palavra-chave Documento no C#, VB.NET, Ruby e Python retorna o objeto da API Documento. 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. Consulte 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. Consulte Exemplos de código fonte de macros.
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. Consulte Desenvolver macros no IDE de macros do Revit.

   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.
   • Consulte Modificando e removendo módulos e macros.