Files
kompas3d-mcp/docs/Kompas3D_SDK/guides/ksaddobjecttomacro.md
T
mikhail e1337e4016 feat(sdk-docs): MD-база знаний SDK — в репозиторий; генератор и зеркало убраны
docs/Kompas3D_SDK/ становится каноническим источником справки КОМПАС SDK
и включается в репозиторий (2491 файл, ~14 МБ). HTML-зеркало
docs/KOMPAS_SDK_ru-RU/ (~1.4 ГБ, © АСКОН) и генератор
tools/build_kompas3d_sdk.py больше не нужны — регенерация не предполагается.

- .gitignore: MD-база разблокирована; зеркало остаётся проигнорированным
  (safety-net на случай повторной локальной выгрузки).
- CLAUDE.md / SKILL.md: убраны упоминания регенерации и зеркала.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-26 20:00:05 +03:00

51 lines
2.3 KiB
Markdown

---
title: "ksAddObjectToMacro - Добавить объект, слой, вид или группу объектов в макроэлемент"
type: guide
api: [api7]
tags: [guide, api7, ksaddobjecttomacro]
sources:
- ksaddobjecttomacro.html
---
*API экспортных функций > Функции работы с графическим документом  > Создание графических объектов  > Работа с макроэлементами и библиотечными макроэлементами  > Функции работы с макроэлементами и библиотечными макроэлементами *
## ksAddObjectToMacro - Добавить объект, слой, вид или группу объектов в макроэлемент
Пример...
Аналог данной функции при использовании Automation - метод ksDocument2D::ksAddObjectToMacro.
Синтаксис:
```
int ksAddObjectToMacro (reference macro,reference obj);
Входные параметры:
macro - указатель на макроэлемент,
obj - указатель на добавляемый объект.
Возвращаемое значение:
1 - в случае успешного завершения,
0 - в случае неудачи.
```
Примечание:
1. Слой и вид добавляются россыпью.
2. Добавляемые объекты и макроэлемент должны принадлежать текущему документу и одному виду.
3. Добавляемые объекты перестают быть самостоятельными.
## ksAddObjectToMacro - пример использования
//создать постоянную группу
//(окружности принадлежат текущему виду)
reference gr = NewGroup (0);
Circle(0, 0, 100, 1);
Circle(0, 0, 50, 1);
EndGroup();
//создать макроэлемент
Macro(1);
LineSeg (120, 100, 120, 150, 1);
reference m = EndObj();
//добавить в макро новый объект
ksOpenMacro(m);
LineSeg (100, 100, 150, 100, 1);
::EndObj();
//добавить в макроэлемент группу самостоятельных объектов.
//(объекты становятся внутренними)