---
title: "FragmentDefinition - Определить данные для вставки фрагмента"
type: struct
api: [api7]
tags: [struct, api7, fragmentdefinition]
sources:
  - fragmentdefinition.html
---

*API экспортных функций > Функции работы с графическим документом  > Функции работы с фрагментами и библиотеками фрагментов  > Функции работы с фрагментами  > Фрагменты *

Пример...
Аналог данной функции при использовании Automation - метод ksFragment::ksFragmentDefinition.
Синтаксис:
```
reference FragmentDefinition (char * fileName,
char * comment,
unsigned char insertType);
Входные параметры:
fileName    - имя файла фрагмента,
comment    - имя вставки,
insertType    - тип вставки (действителен для внешнего фрагмента): 0 - взять в документ, 1 - внешней ссылкой.
Возвращаемое значение:
указатель на определение фрагмента    - в случае успешного завершения,
0    - в случае неудачи.
```
Примечание:
1. Функция определяет данные для вставки фрагмента (внешнего или находящегося непосредственно в документе) с указанным именем по ссылке.
2. Непосредственно вставка фрагмента (вставка ссылки) производится при помощи метода ksFragment::ksInsertFragment.
3. Допускается задание имени фрагмента следующего вида: "c:\gr\lib1.lfr|детали|литье|фланец", где:
– c:\gr\lib1.lfr - имя файла библиотеки фрагментов,
– |детали|литье| - разделы, подразделы внутри библиотеки фрагментов,
– фланец - имя фрагмента.
В этом случае определение создается для фрагмента из библиотеки фрагментов.
4. Определение для данного фрагмента одно; вставок может быть сколько угодно.
5. При использовании Unicode следует использовать функцию FragmentDefinitionW.
