---
title: "Подключение мастера создания библиотек"
type: guide
api: [api7]
tags: [guide, api7, librarywizard]
sources:
  - librarywizard_connect.html
---

*Создание прикладных библиотек  > Мастер создания библиотек *


## Подключение мастера создания библиотек

Для подключения мастера создания библиотек:
1. Скопируйте файлы LibraryWizard.vsz, LibraryWizard.vsdir и LibraryWizard.ico в папку C:\Program Files\Microsoft Visual Studio 8\VC\vcprojects (или в подпапку vcprojects папки, куда установлен Microsoft Visual Studio 2005).
2. Создайте в папке C:\Program Files\Microsoft Visual Studio 8\VC\VCWizards (или аналогичной) папку LibraryWizard2005.
3. Скопируйте в папку LibraryWizard2005 папки: 1033, HTML, Images, Scripts и Templates.


## Создание заготовки библиотеки с использованием Мастера

![Lib_wiz_1](../resources/images_lib_wiz_1.png)

![Lib_wiz_2](../resources/images_lib_wiz_2.png)

![Lib_wiz_3](../resources/images_lib_wiz_3.png)

Чтобы создать заготовку библиотеки с использованием Мастера, следует после запуска Microsoft Visual Studio 2005 выполнить следующие действия.
1. Вызовите команду File - New - Project. На экране появится окно нового проекта (см. рис.).
| |
| --- |
Окно создания нового проекта
2. В списке Project types: выделите пункт Visual C++, затем в списке Templates: выберите LibraryWizard.
3. Введите в поле Name: имя проекта.
4. В поле Location: задайте путь к Include папкам. (По умолчанию эти пути настроены для папки \SDK\C++\Visualc.)
5. Отключите опцию Create directory for solution.
6. Чтобы завершить задание свойств нового проекта, нажмите кнопку ОК.
На экране появится окно Мастера создания библиотек (см. рис.).
| |
| --- |
Мастер создания библиотек - Главное окно
Элементы управления окна позволяют задать параметры заготовки библиотеки.
В поле Имя библиотеки: следует ввести имя, которое будет отображаться в системе КОМПАС при подключении этой библиотеки.
Выберите тип API для программирования – API экспортных функций или Автоматизация.
При использовании Автоматизации добавляется функция для получения интерфейса KompasObject - GetKompas. Добавляется переменная KompasObjectPtr kompas.
При включении опции Характерные точки в проект добавляются файлы, позволяющие библиотеке работать в режиме редактирования характерных точек.
При включении опции События редактирования макрообъекта будет добавлен файл, позволяющий библиотеке обрабатывать события редактирования макрообъекта.
При включении опции Использовать 3D в файле stdfx.h будут сделаны настройки, позволяющие использовать в проекте константы 3D и константы событий 3D.
При включении опции Использовать API7 в файле stdfx.h будут сделаны настройки, позволяющие использовать в проекте интерфейсы API7. Также добавляется функция для получения интерфейса IApplication – GetNewKompasAPI и переменная IApplication newKompasAPI.
При включении опции Панель свойств (она будет доступна только после включения опции Использовать API7) в проект будет добавлен класс для работы с панелью свойств и событиями панели свойств.
При включении опции Панель команд появляется возможность использования библиотеки в режиме «компактная панель команд», также в проект будет добавлена иконка для компактной панели и будут внесены необходимые изменения в файл resource.h.
При включении опции Addins библиотека будет содержать все необходимые функции для работы в этом режиме. Добавляются функции:
•DllRegisterServer - Регистрация библиотеки в реестре,
•DllUnregisterServer - Разрегистрация библиотеки.
Эти функции обеспечивают регистрацию библиотеки в разделе реестра "Software\\ASCON\\KOMPAS-3D\\AddIns\\имя_библиотеки".
Создаются ключи:
•AutoConnect = 1 - Загружать библиотеку при запуске Компас-3D,
•Path - Путь к файлу библиотеки; определяется в момент подключения библиотеки.
При включении опции Локализации библиотеки в проект добавляется файл словаря и специальным образом модифицируется функция для загрузки строк из ресурсов, что позволит в дальнейшем осуществить локализацию библиотеки.
Также имеется возможность отредактировать главное меню библиотеки – Список команд; команды библиотеки можно добавлять, удалять, переименовать и устанавливать очередность их появления в списке.
При включении опции Обрабатывать события в мастере создания библиотек появится возможность перехода к диалогу обрабатываемых событий (см. рис.). Перейти в этот диалог можно по ссылке Выбор событий. В диалоге обрабатываемых событий отображаются все возможные события в зависимости от настроек в Главном окне мастера.
| |
| --- |
Мастер создания библиотек - выбор обрабатываемых событий
В данном диалоге включите нужные опции. В проект будут добавлены все необходимые изменения и файлы, позволяющие библиотеке обрабатывать выбранные события.
Чтобы завершить создание заготовки библиотеки, нажмите кнопку Finish. Чтобы закрыть окно Мастера, отказавшись от сделанных настроек, нажмите кнопку Cancel.
