PDF de programación - Guía de desarrollo de AutoCAD .NET

Guia de desarrollo AutoCAD .NET

Stephen Presto

Autodesk Developer Technical Services Team (DevTech)

Contenido

1 Introducción

.

.

1.1 Organización de la guía .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.2 Visión general de la API .NET de AutoCAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.3 Componentes de la API .NET de AutoCAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.3.1 Utilizar una DLL del API .NET de AutoCAD . . . . . . . . . . . . . . . . . . . . . . . .
1.3.2 Obtener las DLL de la API .NET de AutoCAD . . . . . . . . . . . . . . . . . . . . . . .
1.4 Descripción general de Microsoft Visual Studio . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.4.1 Qué versión de Microsoft Visual Studio debo utilizar . . . . . . . . . . . . . . . . . . .
1.4.2 Utilice la interoperabilidad COM con. NET . . . . . . . . . . . . . . . . . . . . . . . . .
1.4.3 Dependencias y restricciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.5 Para más información .
1.6 Código de muestra .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.
1.7 Transición de ActiveX Automation a .NET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

.
.

.
.

.
.

.
.

2

.

.
.

.
.

.
.

.
.
.

.
.
.

formas .

2.2.1 Módulos de clase .
.
2.2.2
.
2.2.3 Referencias
.

Introducción a Microsoft Visual Studio
2.1 Entender Microsoft Visual Studio Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.2 Definir los componentes de un proyecto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3 Ver información sobre el proyecto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.4 Trabajar con Microsoft Visual Studio Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.4.1 Crear proyecto nuevo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.
2.4.2 Abrir un proyecto existente o una solución . . . . . . . . . . . . . . . . . . . . . . . . .
2.4.3 Guardar un proyecto o una solución . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.4.4 Trabajar con varios proyectos en una solución . . . . . . . . . . . . . . . . . . . . . .
.
2.4.5 Agregar un proyecto a una solución . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.5 Descarga de un proyecto de una solución . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.6 Editar un proyecto existente o una solución . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.
Importación de elementos existentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.7.1 Utilice la ventana de código . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.
2.7.2 Use el Diseñador de Windows Forms . . . . . . . . . . . . . . . . . . . . . . . . . . .
.
2.7.3 Utilice la ventana Propiedades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.7.4 Cambiar el nombre de un proyecto . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.
.
2.7.5 Establezca las opciones para Microsoft Visual Studio . . . . . . . . . . . . . . . . . .
2.8 Carga un ensamblado en AutoCAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2.6.1 Agregar nuevos elementos
2.6.2

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2.7 Editar elementos

.

.

.

.

.

.

.

3
3
3
4
4
5
6
6
7
8
8
8
9

.
.
.
.
.
.
.
.
.
.
.
.

10
. 10
. 11
. 11
. 11
. 11
. 11
. 12
. 12
. 13
. 14
. 14
. 14
. 15
. 15
. 15
. 16
. 16
. 17
. 17
. 18
. 18
. 20
. 20

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

2

2.10.1 Ejercicio: Crear un proyecto nuevo . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.10.2 Ejercicio:Referencia de los archivos API .NET de AutoCAD . . . . . . . . . . . . . .
2.10.3 Ejercicio: Crear un comando nuevo . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.10.4 Ejercicio: Crear y cargar una ensamblado .NET en AutoCAD.

2.9 Acceder y buscar en bibliotecas de referencia (Explorador de objetos) . . . . . . . . . . . . .
.
2.10 Ejercicios: Crear su primer proyecto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.
.
.
. . . . . . . . . . . . . .
2.11 Comandos relacionados con AutoCAD y Terminología . . . . . . . . . . . . . . . . . . . . . .
2.11.1 Comandos AutoCAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.11.2 Terminología .
.
.
.

2.12 Más Información .

.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

.
.

.
.

.
.

.
.

.

CONTENIDO

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

. 21
. 22
. 22
. 22
. 23
. 26
. 26
. 26
. 26
. 27

1 Introducción

En esta introducción se describen los conceptos de la interfaz de programación de aplicaciones (API) AutoCAD®
administradas con el Framework .NET. La API .NET AutoCAD® le permite automatizar tareas como la creación
y modificación de objetos almacenados en la base de datos de un archivo de dibujo o cambiar el contenido de un
archivo de personalización. En esta guía se explica el uso de Microsoft® Visual Studio® 2010, y los lenguajes de
programación Microsoft® Visual Basic® .NET (denominada en esta guía como VB .NET) y Microsoft Visual C#® con
API .NET AutoCAD® .
Temas de esta sección

• Organización de la guía

• Visión general de la API .NET de AutoCAD

• Componentes de la API .NET de AutoCAD

• Descripción general de Microsoft® Visual Studio®

• Para obtener más información

• Ejemplo de código

• Transición de ActiveX Automation a .NET

1.1 Organización de la guía

Esta guía proporciona información sobre cómo utilizar la API .NET de AutoCAD con Microsoft Visual Studio y
los lenguajes de programación VB.NET y C#. Información específica para el desarrollo de aplicaciones con Microsoft
Visual Studio se pueden encontrar en los temas "Introducción a Microsoft Visual Studio" y "Desarrollo de aplicaciones
con Microsoft Visual Studio".
Los programadores familiarizados con el Framework .NET utilizando un entorno de desarrollo de Microsoft Visual
Studio pueden omitir estos dos capítulos. Sin embargo, todo el código de ejemplo en esta guía se presenta en VB
.NET y C#.

1.2 Visión general de la API .NET de AutoCAD

La API .NET de AutoCAD le permite manipular archivos de dibujo de AutoCAD con los ensamblados o bibliotecas
que están disponibles. A estos objetos se pueden acceder mediante muchos lenguajes de programación y entornos
diferentes.

4

Introducción

Hay varias ventajas de la implementación de un API .NET para AutoCAD:

• El acceso mediante programación a los dibujos de AutoCAD se abre a más entornos de programación. Antes
de la API .NET, los desarrolladores se limitaban a ActiveX Automation® y los idiomas que apoyaron COM,
AutoLISP® y con ObjectARX C++.

• La integración con otras aplicaciones basadas en Windows® como Microsoft Excel y Word, se hace más fácil

mediante el uso de una aplicación nativa API .NET o enlazados a una biblioteca ActiveX/COM.

• El Framework .NET está diseñado para sistemas operativos de 32-bit y 64-bit. Visual Basic para Aplicaciones

ha sido diseñado sólo para sistemas operativos de 32 bits.

• Permite el acceso a las interfaces avanzadas de programación con una curva de aprendizaje más baja comparada

a los lenguajes de programación más tradicionales, tales como C++.

Los objetos son los bloques de construcción principales de la API .NET de AutoCAD. Cada objeto representa una
parte de AutoCAD, y se agrupan en diferentes ensamblados y espacios de nombres. Hay muchos tipos diferentes de
objetos de la API .NET de AutoCAD. Por ejemplo:

• Los objetos gráficos como líneas, arcos, texto y cotas

• Los ajustes de estilo tales como estilos de texto y dimensión

• Estructuras organizacionales, tales como capas, grupos y bloques

• Las presentaciones de dibujo como la vista y la vista preliminar

• El dibujado y aplicaciones AutoCAD

Para obtener información sobre algunos de los archivos que componen el API .NET de AutoCAD, consulte Compo-
nentes de la API .NET de AutoCAD.

1.3 Componentes de la API .NET de AutoCAD

La API .NET de AutoCAD se compone de archivos DLL diferentes que contienen una amplia gama de clases, estruc-
turas, métodos, y eventos que proporcionan acceso a los objetos en un archivo de dibujo o una aplicación AutoCAD.
Cada archivo DLL define espacios de nombres diferentes que se utilizan para organizar los componentes de las
bibliotecas basadas en su funcionalidad.
Las tres principales archivos DLL de la API .NET de AutoCAD que con frecuencia se utilizan son:

• AcDbMgd.dll Se utiliza cuando se trabaja con objetos en un archivo de dibujo.

• AcMgd.dll Se utiliza cuando se trabaja con la aplicación AutoCAD.

• AcCui.dll Se utiliza cuando se trabaja con archivos de personalización.

• AcCoreMgd.dll Necesario en AutoCAD 2013

1.3.1 Utilizar una DLL del API .NET de AutoCAD

Antes de clases, estructuras, métodos y eventos que se encuentran relacionados en con una DLL de la API .NET de
AutoCAD para ser utilizado debe hacer referencia al archivo DLL en un proyecto. Después que una DLL se referencia
a un proyecto, puede utilizar los espacios de nombres y los componentes en el archivo DLL