1.3. Компоненты AutoCAD .Net API

Источник здесь[перевод не проверен];[перевёл Андрей Бушман]

AutoCAD .NET API собран из различных DLL-файлов, которые содержат широкий ряд классов, структур, методов и событий, обеспечивающих доступ к объектам файла чертежа в приложении AutoCAD. Каждый DLL-файл определяет различные пространства имен, которые используются для организации размещения компонентов библиотек собранных сообразно своему функционалу.

Существует три* основных DLL-файла AutoCAD .NET API, которые вы будете часто использовать:

  1. AcDbMgd.dll. Используется для работы с объектами файла чертежа.
  2. AcMgd.dll. Используется для работы с  самим приложением AutoCAD. 
  3. AcCui.dll. Используется для работы с файлами пользовательских настроек.
  4. [Примечание переводчика: * начиная с AutoCAD 2013 появился файл AcCoreMgd.dll (доп. инф. здесь].

Прежде чем начать использовать классы, структуры, методы и события AutoCAD .NET API, следует в проекте предварительно подключить соответствующие DLL-файлы, после чего установить ссылки на необходимые пространства имён.  После указания в проекте ссылки на DLL-файл, позволяющий вам использовать AutoCAD .NET API, вы должны установить  свойство «Copy Local» (локальная копия) подключаемой библиотеки в значение  «False».  Данное свойство отвечает за то, будет ли MS Visual Studio создавать копию DLL-файла, на который ссылается, размещая её в некоторой директории, входящей в состав сборки проекта, когда он будет компилироваться в CIL-код.  С тех пор, как DLL-файлы, на которые указывают ссылки стали поставляться в составе AutoCAD, создание их копий  может послужить причиной непредвиденных результатов, когда вы будете загружать файл своей сборки в AutoCAD.

AutoCAD .NET API DLL могут быть расположены в <drive>:\Program Files\AutoCAD 2010 или являться частью AutoCAD 2010 ObjectARX SDK, который может быть загружен из http://www.objectarx.com или с сайта разработчиков компании Autodesk (http://www.autodesk.com/adn). 

После того, как вы инсталлируете ObjectARX SDK, соответствующий вашей версии AutoCAD, DLL-файлы могут быть так же найдены вами в его дочерних каталогах inc-win32 и inc-x64.

Примечание: 
DLL-файлы, входящие в состав ObjectARX SDK, являются упрощенными версиями некоторых файлов, которые поставляются в составе AutoCAD, так как они не содержат зависимостей от пользовательского интерфейса AutoCAD. Рекомендуется загрузить и установить ObjectARX SDK с тем, чтобы в дальнейшем, в своих проектах, вы могли ссылаться на входящие в его состав DLL-файлы в качестве исходных библиотек, вместо подключения одноимённых DLL-файлов из каталога самого AutoCAD 2010.

1. Скачать и установить AutoCAD 2010 ObjectARX SDK

1.1. Откройте в своём Интернет-браузере сайт http://www.objectarx.com.
1.2. На открывшейся странице сайта нажмите «License & Download».
1.3. На открывшейся странице заполните все поля, обязательные к заполнению и выберите «ObjectARX for AutoCAD 2010». Затем нажмите «Submit».
1.4. На открывшейся странице загрузки нажмите «Download Now» для использования «Download Manager», или нажмите «Standard Download Method» для выбора метода загрузки, используемого вашим Интернет-браузером по умолчанию.
1.5. Нажмите «Save» и, если потребуется, укажите место, куда следует сохранить скачиваемый вами файл.
1.6. После того, как файл будет скачан, запустите его двойным щелчком мыши.
1.7. В открывшемся диалоговом окне ObjectARX <Версия> укажите каталог, в котором хотите разместить файлы, подлежащие распаковки, или согласитесь с путём, предложенным по умолчанию. Нажмите «Install».
1.8. Если в процессе установки не возникнет проблем, мастер инсталляции сам автоматически закроется по завершению всех необходимых операций.

2. Установить ObjectARX Wizard и шаблоны управляемых проектов

2.1. После того, как вы выполните все подпункты п.1, откройте каталог, который по умолчанию выглядит так: «C:\ObjectARX <Версия>».
2.2. В этом каталоге найдите и откройте каталог «Utils», в котором, в свою очередь, откройте каталог «ObjARXWiz».
2.3. В каталоге «ObjARXWiz» двойным щелчком мыши запустите файл «ArxWizards.msi».
2.4. В окне «ObjectARX Wizard for AutoCAD 2010» нажмите кнопку «Next».
2.5. В диалоговом окне «Enter Your Preferred Default RDS Symbol» укажите аббревиатуру имени вашей компании и нажмите кнопку «Next».
Текст, который вы указываете в RDS, будет использоваться по умолчанию как префикс для имён классов или команд, создаваемых в «ObjectARX Wizard» и шаблонах проектов.
Примечание: Указание RDS (Registered Developer Symbol) в качестве Регистрационного Символа Разработчика, и его дальнейшее использование создаёт уникальные имена команд и классов, позволяющих устранить потенциально возможный конфликт имён, который мог бы возникнуть при совместной работе с приложениями других разработчиков.

3. Подключение библиотек .Net API

3.1. В Microsoft Visual Studio в меню "View" выберите пункт "Solution Explorer", для отображения одноимённого окна, если это не сделано ранее.
3.2. В панели инструментов окна "Solution Explorer" кликните мышью на кнопке "Show All Files", для отображения всех файлов.
3.3. Правым кликом мыши на элементе "References" (Ссылки) вызываем контекстное меню и выбираем в нем пункт "Add Reference..." (Добавить ссылку).
3.4. В открывшемся окне "Add Reference" переходим на вкладку "Browse" и выбираем DLL файл, который содержит нужную нам библиотеку, после чего жмём клавишу ОК.
3.5. В "Solution Explorer" кликаем мышью по значку плюса, расположенного левее элемента "References", для его раскрытия.
3.6. Выбираем подключенную нами библиотеку из списка раскрывшихся элементов.
3.7. Из контекстного меню выбранной нами библиотеки выбираем пункт "Properties".
3.8. В открывшемся окне "Properties" выбираем свойство "Copy Local" и устанавливаем для него значение "False" из раскрывающегося списка.

Ссылки по теме

  1. Kean Walmsley

Comments