kompas3d-mcp/docs/Kompas3D_SDK/interfaces/iinsertslibrary.md

---
title: "Интерфейс IInsertsLibrary"
type: interface
api: [api7]
tags: [interface, api7, iinsertslibrary]
sources:
  - iinsertslibrary.html
---

*API интерфейсов. Версия 7 > Менеджер библиотек  > Интерфейс ILibrary  > ILibrary - методы *


## Интерфейс IInsertsLibrary

Интерфейс библиотеки элементов (документов) Компас.
Иерархия:
IKompasAPIObject
ILibrary
IInsertsLibrary
Описание:
Позволяет получить доступ к библиотеке элементов (документов) системы КОМПАС (фрагментов или моделей), редактировать структуру библиотеки, получить доступ к коллекции элементов (документов) библиотеки.
Примечание:
Интерфейс библиотеки фрагментов или моделей системы КОМПАС можно получить у интерфейса IInsertsLibraries с помощью свойства IInsertsLibraries::Item.


## ActiveFolder - Активная папка в окне библиотеки элементов

Функция не поддерживается
Тип данных: BSTR (строка)
Синтаксис Automation:
```
ActiveFolder = iObject.ActiveFolder    Получить свойство (* )
ActiveFolder = iObject.GetActiveFolder    Получить свойство (**)
```
Синтаксис COM:
```
iObject->get_ActiveFolder (&ActiveFolder)    Получить свойство
```
Примечание:
Свойство позволяет получить активную папку в окне библиотеки.


## AddFolder - Добавить папку в библиотеку элементов

Функция не поддерживается
Синтаксис Automation:
```
BOOL AddFolder (BSTR PathFolder);
```
Синтаксис COM:
```
HRESULT AddFolder ([in] BSTR PathFolder, [out, retval] VARIANT_BOOL* pVal);
Входные параметры:
PathFolder    - путь к папке,
post    - TRUE - отложенное выполнение.
Возвращаемое значение:
TRUE    - в случае успеха,
FALSE    - в случае неудачи.
```
Примечание:
Добавляет новую папку в библиотеку элементов.


## Delete - Удалить описание библиотеки

Синтаксис Automation:
```
BOOL Delete();
```
Синтаксис COM:
```
HRESULT Delete( BOOL* Result );
Возвращаемое значение:
TRUE    - в случае успеха,
FALSE    - в случае неудачи.
```


## Inserts - Коллекция элементов (документов) библиотеки

Тип данных: указатель на интерфейс IInserts
Синтаксис Automation:
```
Inserts = iObject.Inserts    Получить свойство (* )
Inserts = iObject.GetInserts    Получить свойство (**)
```
Синтаксис COM:
```
iObject->get_Inserts (&Inserts)    Получить свойство
```
Примечание:
Свойство позволяет получить коллекцию элементов (документов) библиотеки.


## IsDocumentExist - Функция проверяет существование документа с именем в библиотеке документов

Синтаксис Automation:
```
BOOL IsDocumentExist( BSTR DocumentPath );
```
Синтаксис COM:
```
HRESULT IsDocumentExist( BSTR DocumentPath, BOOL * Result );
Входные параметры:
DocumentPath    - путь к документу внутри библиотеки документов.
КOMPAS v24
```


## IsPredefinedTextLibrary - Использовать библиотеку для вставки типовых текстов

Тип данных: BOOL
Синтаксис Automation:
```
IsPredefinedTextLibrary = Object.IsPredefinedTextLibrary    Получить свойство (* )
Object.IsPredefinedTextLibrary = IsPredefinedTextLibrary    Установить свойство (* )
IsPredefinedTextLibrary = Object.GetIsPredefinedTextLibrary()    Получить свойство (**)
Object.SetIsPredefinedTextLibrary( IsPredefinedTextLibrary )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_IsPredefinedTextLibrary( &IsPredefinedTextLibrary )    Получить свойство
Object.put_IsPredefinedTextLibrary( IsPredefinedTextLibrary )    Установить свойство
КOMPAS v24
```


## RemoveFolder - Удалить папку из библиотеки элементов

Функция не поддерживается
Синтаксис Automation:
```
BOOL RemoveFolder (BSTR PathFolder);
```
Синтаксис COM:
```
HRESULT RemoveFolder ([in] BSTR PathFolder, [out, retval] VARIANT_BOOL* pVal);
Входные параметры:
PathFolder    - путь к папке,
post    - TRUE - отложенное выполнение.
Возвращаемое значение:
TRUE    - в случае успеха,
FALSE    - в случае неудачи.
```
Примечание:
Удаляет папку из библиотеки элементов.


## SetActiveFolder - Установить активную папку в окне библиотеки элементов (документов)

Функция не поддерживается
Синтаксис Automation:
```
BOOL SetActiveFolder (BSTR PathFolder, BOOL LastIsFile, BOOL HaveLibName);
```
Синтаксис COM:
```
HRESULT SetActiveFolder ([in] BSTR PathFolder,
VARIANT_BOOL LastIsFile,
VARIANT_BOOL HaveLibName,
[out, retval] VARIANT_BOOL * pVal);
Входные параметры:
PathFolder    - путь к папке,
LastIsFile    TRUE - в пути имеется имя файла документа,
HaveLibName(BOOL)    - TRUE - в пути имеется имя библиотеки.
Возвращаемое значение:
TRUE    - в случае успеха,
FALSE    - в случае неудачи.
```
Примечание:
Метод позволяет установить активную папку в окне библиотеки документов. Путь к папке может содержать или не содержать имя библиотеки и имя документа. Имя библиотеки, имя папки и имя документа разделяются символом "|". Если папка является вложенной, т. е. находится внутри другой папки, названия папок в пути отделяются символом "|".
Пример. Библиотека с именем 111, содержит папку с именем ddd, в которой находится файл с именем fragment. Путь к этому файлу должен быть задан следующим образом: 111|ddd|fragment.