O site de arquitetura mais visitado do mundo
Tudo
Projetos
Produtos
Eventos
Concursos
  1. ArchDaily
  2. Artigos
  3. Como escrever seu primeiro Revit Macro em 7 etapas fáceis

Como escrever seu primeiro Revit Macro em 7 etapas fáceis

  • 07:00 - 9 Novembro, 2016
  • por Michael Kilkelly
  • Traduzido por Julia Brant
Como escrever seu primeiro Revit Macro em 7 etapas fáceis
Como escrever seu primeiro Revit Macro em 7 etapas fáceis, Cortesia de ARCHSMARTER
Cortesia de ARCHSMARTER

Os macros representam uma das formas mais fáceis de automatizar o Revit. Eles permitem ampliar as capacidades de seu software e fazê-lo trabalhar segundo os seus interesses. Macros não requerem nenhum software adicional além do próprio Revit e é uma boa forma para iniciantes aprenderem programação.

Então, o que exatamente é um macro? Um macro é um comando criado por usuários que é codificado utilizando o API do Revit. Os macros são processados diretamente dentro do Revit e são salvos na pasta do projeto. Outros aplicativos, como o MS Office, fornecem a capacidade de gravar macros diretamente a partir de suas ações na tela. Infelizmente, o Revit não tem essa funcionalidade. É necessário codificar suas macros do Revit diretamente.

Seu primeiro Revit Macro

Pronto para escrever seu primeiro macro? Como você verá, o processo é muito simples. Siga os passos abaixo e você estará encaminhado para a maestria macro.

1. Abra o Gerenciador Revit Macro

Crie uma nova pasta de projeto. Clique na faixa Gerenciar e, em seguida, clique no ícone Gerenciador de Macro. Isso abrirá a caixa de diálogo Gerenciador de macro.

Cortesia de ARCHSMARTER
Cortesia de ARCHSMARTER

As macros podem residir em um arquivo de projeto ou dentro do Revit. As macros salvas no arquivo de projeto podem ser usadas por qualquer usuário que abra esse arquivo. As macros salvas no aplicativo são salvas na configuração do Revit do usuário. Essas macros podem ser usadas em qualquer arquivo de modelo, mas apenas pelo usuário que criou a macro.

Cortesia de ARCHSMARTER
Cortesia de ARCHSMARTER

2. Crie um Novo Módulo

Macros são organizados em módulos. Para criar um macro em uma nova pasta de projeto, é necessário, primeiro, criar um novo módulo. Um módulo é simplesmente um conjunto de macros. Uma única pasta de projeto pode conter uma série de módulos que, por sua vez, possuem seus próprios macros. Os nomes dos módulos não podem conter espaços ou caracteres especiais. Para criar um módulo, clique na aba "Projeto 1" e então clique no botão Módulo na sessão "Criar". Na caixa de diálogo "Criar um novo módulo", nomeie seu módulo "MeuPrimeiroModulo". Você pode escrever macros em C#, VB.Net, Python ou Ruby. Para este exercício, escolha VB.Net na linguagem de módulos. Clique OK para criar o módulo.

Cortesia de ARCHSMARTER
Cortesia de ARCHSMARTER

Uma vez que o Revit cria o módulo, o SharpDevelop vai carregar. SharpDevelop é um código aberto de ambiente desenvolvido que é criado dentro do Revit para programar macros.

3. Crie um Novo Macro

Agora que você tem um módulo, você pode criar um macro dentro do módulo. Clique no botão Macro na sessão "Criar" da caixa de diálogo do Gerenciador de Macros. Na caixa de diálogo "Criar um Novo Macro", nomeie seu macro "MeuPrimeiroMacro" e configure nas linguagem VB.Net. Clique OK para criar o macro.

Cortesia de ARCHSMARTER
Cortesia de ARCHSMARTER

4. Escreva um Macro

Mude para SharpDevelop. Você verá o código padrão VB.Net que é gerado automaticamente quando você cria um novo módulo. Na parte inferior você verá o código inicial para "MeuPrimeiroMacro". Seu primeiro macro é simplesmente surgirá em uma caixa de mensagem no Revit. Basta apenas uma linha de código. Após o "public void MeuPrimeiroMacro ()", digite o seguinte entre os colchetes:

Cortesia de ARCHSMARTER
Cortesia de ARCHSMARTER

5. Construa o Macro

Uma vez que você digitou o código, você está apto a compilar, ou "construir" o macro. Todos os macros devem ser construídos antes do Revit possa rodá-los. Na barra do menu SharpDevelop, selecione "Construir", e então "Solução Construtiva".

Cortesia de ARCHSMARTER
Cortesia de ARCHSMARTER

SharpDevelop irá compilar o seu código VB.Net em um código intermediário .Net. Qualquer erro ou aviso aparecerá na janela "Erros e Avisos" localizada na parte de baixo da interface SharpDevelop.

Cortesia de ARCHSMARTER
Cortesia de ARCHSMARTER

Caso você tenha qualquer erro, cheque mais uma vez seu código. A janela de código listará os erros por linhas de números, então é simples identificá-los. 

6. Rode o Macro

Caso seu macro tenha sido compilado corretamente, volte para o Revit e abra a caixa de diálogo de Gerenciador de Macro (Manage > Macro Manager).

Cortesia de ARCHSMARTER
Cortesia de ARCHSMARTER

Selecione "MeuPrimeiroMacro" na lista e, então clique do botão "Rodar". Isso executará seu macro. Você deve ver o seguinte na tela:

Cortesia de ARCHSMARTER
Cortesia de ARCHSMARTER

Você conseguiu! Você escreveu seu primeiro Revit Macro.

7. Faça Algumas Alterações

Para prolongar esse processo, você pode modificar o código para reportar de volta a algo mais útil. Mude o código para o seguinte:

Cortesia de ARCHSMARTER
Cortesia de ARCHSMARTER

O objeto "Me.Application.ActiveUIDocument" representa o seguinte modelo de pasta. O objeto "Documento" contém dados do próprio arquivo em si. Para ver a visualização ativa na atual pasta de projeto, altere “Document.PathName” para “ActiveView.Name”. Note o underline ("_") no código acima. Este caractere representa o símbolo de continuação da linha. Isso informa ao SharpDevelop que o código continua na linha abaixo. Os símbolos de continuidade de linhas são utilizados para imprimir longas linhas de código para uma página. Quando você está digitando o código, você pode omitir o "_" e digitar o código em uma única linha.

Seu Próximo Revit Macro

Nosso primeiro macro foi útil para ilustrar o processo de criação de um macro, mas vamos utilizemos o que acabamos de aprender e colocar em prática na criação de um macro que seja mais útil. O seguinte código deleta visualizações inutilizadas na atual pasta modelo. Caso uma visualização não esteja em uma página, ela é deletada. Note que este maro não funciona em visualizações dependentes. Para testar suas novas habilidades de codificar macros, crie um novo macro e digite o seguinte código:

Cortesia de ARCHSMARTER
Cortesia de ARCHSMARTER

Depois de digitar o código, clique em Construir > Soluções Construtivas para compila-lo. Talvez você tenha algum erro ou outro, mas é normal. Use os passos em destaque na sessão de destaque de problemas acima e tente resolver os erros. Cheque os erros de digitação em seu código - é isso que geralmente me atrapalha! Uma vez que o código esteja construído corretamente, abra o Revit e rode o macro.

Próximos Passos

Parabéns! Agora você está encaminhado para a maestria Revit! Ao mesmo tempo que este tutorial é muito básico, ele ilustra a escrita de macros no Revit. Para um próximo passo, eu recomendo baixar e instalar o Revit 2017 Software Development Kit ou SDK. O SKD contém arquivos de suporte e códigos amostrais que podem ajudar a aprender programação de macros. O Revit 2017 SDK é instalado de uma página principal do instalador do Revit ou ele pode ser baixado a partir do site Autodesk Developer Network. O SDK instalará no seu hard drive e criará uma série de sub-arquivos e pastas. Salve algum tempo para revisitar os arquivos. As amostras de macro são particularmente úteis a partir do momento que você começar a criar seus próprios macros.

Conclusão

Aprender a escrever macros e automatizar o Revit vai melhorar drasticamente sua eficiência. Um macro bem-escrito pode fazer em cinco muitos mais do que um usuário comum pode completar em uma hora. Aprender a programar leva tempo e paciência. Comece com calma e trabalhe sistematicamente. Você estará no seu caminho para a maestria macro a tempo!

Bonus Exclusivo! Clique aqui para fazer o download PDF detalhado e aprimorado deste tutorial, juntamente com uma lista de recursos para ajudá-lo a escrever seus próprios macros do Revit que economizam tempo.

Sobre este autor
Cita: Kilkelly, Michael. "Como escrever seu primeiro Revit Macro em 7 etapas fáceis" [How to Write Your First Revit Macro in 7 Easy Steps] 09 Nov 2016. ArchDaily Brasil. (Trad. Brant, Julia) Acessado . <https://www.archdaily.com.br/br/799023/como-escrever-seu-primeiro-revit-macro-em-7-etapas-faceis> ISSN 0719-8906

¡Você seguiu sua primeira conta!

Você sabia?

Agora você receberá atualizações das contas que você segue! Siga seus autores, escritórios, usuários favoritos e personalize seu stream.