Visão geral do meu primeiro plug-in do AutoCAD

Autodesk Support

31 de março de 2023


Visão geral do meu primeiro plug-in do AutoCAD> Lição 1 > Lição 2 > Lição 3 > Lição 4 > Lição 5 >> Lição 6 >> Lição 7 > Lição 8

"Meu primeiro plug-in" é um guia de tutorial de ritmo próprio para uma introdução suave ao mundo da programação. Este é um caminho de aprendizagem "um único ponto" para usuários que conhecem os produtos da Autodesk, mas são absolutamente novos em programação e estão pensando em assumir o controle. Neste guia, você trabalhará com a API (Application Programming Interface) do AutoCAD .NET e a linguagem de programação Visual Basic .NET para criar um "plug-in" - um módulo que é carregado no AutoCAD para estender sua funcionalidade. Após concluir este tutorial, você compreenderá os conceitos básicos da programação do .NET e como eles são aplicados ao AutoCAD.

Produto: AutoCAD*;
Linguagem de programação: Visual Basic .NET
Interface de programação de aplicativo (API): API .NET do AutoCAD

*Este guia foi criado para o AutoCAD 2024 "básico". No entanto, todas as etapas deste guia são aplicáveis a qualquer produto "vertical" do AutoCAD (AutoCAD Architecture, AutoCAD Civil 3D, etc.). A API .NET do AutoCAD é comum a todos esses produtos; cada vertical adiciona sua própria API especializada sobre a API .NET do AutoCAD. O código arquivado anexado funcionará no AutoCAD 2020, 2021, 2023 e 2024.

Visão geral

Há muitos recursos disponíveis na Web para você saber mais sobre a API .NET do AutoCAD. Mas esses recursos tendem a ser destinados a pessoas que já conhecem programação. Este guia é diferente: ele não assume nenhum conhecimento anterior de programação e, ainda assim, ajuda a criar seu primeiro plug-in rapidamente, sem trocar de detalhes. Você terá um aplicativo de trabalho dentro de uma hora após iniciar este material, independentemente do seu nível atual de experiência em programação.

O guia começará analisando os benefícios de personalizar o software Autodesk antes de passar para as lições que abrangem o uso da API .NET do AutoCAD. As lições começarão por construir um plug-in de trabalho antes de abranger explicações mais detalhadas dos princípios subjacentes e desenvolver ainda mais a funcionalidade do plug-in.

Os benefícios de personalizar o AutoCAD

Tempo é dinheiro! Quanto mais eficiente for a execução de operações de rotina, mais competitivo você estará na economia atual. Este é um benefício importante da personalização: a adaptação do software que você usa diariamente para simplificar ou automatizar seus fluxos de trabalho. A Autodesk fornece APIs e SDKs (Software Development Kits, kits de desenvolvimento de software) poderosos que permitem que você obtenha mais valor de seu investimento em software Autodesk adaptando-o às necessidades de seus negócios - personalizando os recursos existentes do produto ou adicionando recursos totalmente novos.

O AutoCAD tem quatro APIs diferentes - .NET, LISP, AtiveX e ObjectARX (C++). Este tutorial usa o .NET porque ele oferece o ambiente de programação mais poderoso e moderno - combinando a API do AutoCAD .NET muito abrangente com as ferramentas de programação mais modernas (o Microsoft .NET Framework e o Microsoft Visual Studio). O .NET fornece acesso a qualquer uma das linguagens de programação compatíveis com o .NET (Visual Basic .NET, C#, F#, etc.) para desenvolver plug-ins. Embora cada linguagem tenha seus próprios benefícios relativos, o Visual Basic .NET é a escolha natural para iniciantes: é a mais fácil de aprender e usar; é a mais humana legível; e (como qualquer outra linguagem .NET) ele fornece acesso completo ao poder do Microsoft .NET Framework subjacente. À medida que você se familiarizar com o conteúdo deste guia - e com o Visual Basic .NET mais proficiente - poderá seguir em frente para resolver problemas mais complexos com o idioma.

A programação pode ser muito gratificante. Esperamos que também se sinta assim depois de concluir estas lições. Divirta-se!

Resumo do plug-in

"Meu primeiro plug-in" implementa um comando que permite selecionar inserções de bloco no desenho com atributos que você deseja manter paralelos ao eixo x do WCS, independentemente da rotação da inserção do bloco. Ou seja, os atributos do bloco sempre permanecem horizontais no WCS.

Manter o texto de anotação na horizontal para o leitor é um requisito comum, e este plug-in simples facilita muito. O plug-in finalizado pode ser facilmente estendido para cobrir outros objetos de anotação, como Texto e Mtext; e para exibir texto sempre na horizontal da vista, não apenas o WCS.

Ampliar

O plug-in completo 
Este vídeo demonstra o plug-in final que você criará na lição 6 deste guia "Meu primeiro plug-in".

Software a ser instalado antes de iniciar

  • AutoCAD
    Ou qualquer outro produto baseado no AutoCAD. Este guia é aplicável a todos os produtos baseados no AutoCAD. Substitua o texto '20xx' pela versão do produto que você está usando em todo o guia.
  • Comunidade do Microsoft® Visual Studio® Este tutorial usará o Visual Basic Express, mas você também pode usar o Visual Studio. Alguns elementos da interface do usuário podem diferir entre as versões do Visual Studio
  • O SDK do ObjectARX
    O SDK do ObjectARX inclui a documentação para a API do AutoCAD .NET (também conhecida como a API gerenciada) e alguns arquivos importantes que devemos referenciar de nosso projeto do Visual Studio. Ele também inclui uma série de exemplos de projetos .NET. (O SDK contém documentação e arquivos para a API ObjectARX (C++) e para a API .NET. Não deixe que toda a documentação C++ o preocupe (o .NET é muito mais fácil).
  • Os Assistentes do AutoCAD .NET
    Os Assistentes são modelos simples que você pode usar para criar rapidamente novos projetos do AutoCAD .NET (Visual Basic ou C#). Importante para os usuários do Visual Basic Express, eles configuram o projeto para permitir que você inicie o AutoCAD a partir do seu depurador - algo que não é possível através da interface do usuário do Visual Studio Express.

Resumo das lições

Crie seu primeiro plug-in básico do AutoCAD para manter os atributos de bloco na horizontal. Nesta primeira versão do plug-in, o comportamento de cada bloco no desenho é modificado da mesma forma. Você adicionará código mais tarde para permitir que você selecione quais blocos exibem esse comportamento alterado e quais mantêm o comportamento padrão do AutoCAD.

Veja mais de perto o que acontece quando você executa o código de plug-in; explore o ambiente de desenvolvimento do Visual Basic Express; e saiba como passar pelo código no depurador.

Dê uma olhada detalhada na API do AutoCAD .NET. Você passará algum tempo examinando o código Visual Basic .NET que digitou no projeto do plug-in na Lição 1, examinando cada uma das linhas de código por sua vez. Além disso, você aprenderá sobre alguns conceitos básicos de programação, como Programação orientada a objetos, classes, métodos, declarações de variáveis, criação de objetos de classe e propriedades.

Saiba como usar o depurador do Visual Studio para passar por seu código linha a linha para seguir a execução do programa e para observar os valores de variáveis conforme são alterados pelo seu código.

Estenda o plug-in para solicitar ao usuário a entrada - selecionando a quais blocos o comportamento alterado será aplicado. Você também aprenderá sobre a identificação exclusiva de um objeto em um desenho usando Handles e ObjectIds.

Complete e melhore a funcionalidade do plug-in estendendo-o para permitir que o AutoCAD armazene dados no arquivo DWG - para que seu plug-in lembre quais blocos você selecionou, mesmo quando um desenho é reaberto após ser salvo. Você também aprenderá como usar loops e declarações condicionais.

Informações sobre recursos adicionais para continuar aprendendo a API do AutoCAD .NET, incluindo arquivos de ajuda, documentação, amostras e outros tutoriais.

Conclua o tutorial estudando um plug-in bônus (um pouco mais complicado) que estende a funcionalidade do plug-in que você desenvolveu para fornecer o comportamento completo de ‘outdoor’ para atributos de bloco.

Visão geral do meu primeiro plug-in do AutoCAD> Lição 1 > Lição 2 > Lição 3 > Lição 4 > Lição 5 >> Lição 6 >> Lição 7 > Lição 8



Essas informações foram úteis?


Precisa de ajuda? Pergunte ao Autodesk Assistant!

O assistente pode ajudar você a encontrar respostas ou falar com um agente.


Qual é o seu nível de suporte?

Diferentes planos de assinatura oferecem categorias distintas de suporte. Saiba qual é o nível de suporte do seu plano.

Visualizar níveis de suporte