---
title: "Оформление прикладных библиотек KsAPI"
type: guide
api: [api7]
tags: [guide, api7, oformlenie]
sources:
  - oformlenie_ksapi_libs.html
---

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


## Оформление прикладных библиотек KsAPI

Функции оформления библиотек KsAPI
Пример простейшей C++ программы, оформленной в виде библиотеки КОМПАС-3D, выполненной на KsAPI
Функции обработчики приложения KsAPI


## Пример простейшей C++ программы, оформленной в виде библиотеки КОМПАС-3D, выполненной на KsAPI

// ---
#include <KsAPI.h>
#include <KompasLibraryActions.h>
static ksapi::IApplication * kompasApp = nullptr;
//------------------------------------------------------------------------------
/**
Обработчик команд библиотеки.
*/
//---
void RunCommand(unsigned int commandId, ksapi::RunCommandMode mode)
{
if (kompasApp)
kompasApp->ShowMessageBox(L"ПРИВЕТ !!!", L"", ksMessageWarning, ksButtonSetOk, true);
}
//------------------------------------------------------------------------------
/**
Инициализация библиотеки.
*/
//---
APP_EXP_FUNC(bool) LoadKompasLibrary(ksapi::IApplication & app, ksapi::IKompasLibraryActions & libaryActions)
{
libaryActions.AddRunCommandHandler(RunCommand);
kompasApp = &app;
return true;
}
//------------------------------------------------------------------------------
/**
Освобождения ресурсов перед выгрузкой библиотеки.
*/
//---
APP_EXP_FUNC(void) UnloadKompasLibrary()
{
}
Функция LoadKompasLibrary является точкой входа и передает управление КОМПАС-3D приложению. В этой функции происходит инициализация функторов оформления библиотек, использующая методы /*IKompasLibraryActions*/. В данном случае она добавляет обработчик команд приложения, используя метод /*IKompasLibraryActions::AddRunCommandHandler*/, при этом  RunCommand обеспечивает выдачу сообщения при вызове команды приложения.


## Функции оформления библиотек KsAPI

В отличие от ранних версий библиотек систем КОМПАС-3D, создаваемых с помощью  стандартных систем программирования и оформляемых в виде разделяемых DLL-библиотек  WINDOWS, у библиотек, создаваемых на прикладных интерфейсах KsAPI, появилась возможность компилирования и исполнения не только на WINDOWS-системах, но и на устройствах, имеющих операционные системы на базе ядра Linux.
Чтобы создать приложение с использованием интерфейсов KsAPI, следует использовать функции оформления библиотек  KsAPI. Они обеспечивают взаимодействие системы КОМПАС-3D и приложения.
Функции LoadKompasLibrary и UnloadKompasLibrary являются единственными и обязательными в исполняемом файле приложения. Их наличие позволяет системе КОМПАС-3D идентифицировать произвольный DLL-файл как собственную библиотеку.
LoadKompasLibrary является головной функцией библиотеки (точкой входа) и ей передается управление при обращении к приложению.
UnloadKompasLibrary является точкой выхода из KsAPI-приложения и выполняется при закрытии  КОМПАС-3D или при отключении библиотеки из Конфигуратора.
