mikhail
e1337e4016
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>
59 lines
3.3 KiB
Markdown
59 lines
3.3 KiB
Markdown
---
|
|
title: "NewGroup - Создать новую группу объектов"
|
|
type: guide
|
|
api: [api7]
|
|
tags: [guide, api7, newgroup]
|
|
sources:
|
|
- newgroup.html
|
|
---
|
|
|
|
*API экспортных функций > Функции работы с графическим документом > Работа с группами объектов > Функции работы с группами объектов *
|
|
|
|
|
|
## NewGroup - Создать новую группу объектов
|
|
|
|
Пример...
|
|
Аналог данной функции при использовании Automation - метод ksDocument2D::ksNewGroup.
|
|
Синтаксис:
|
|
```
|
|
reference NewGroup (int type);
|
|
Входной параметр:
|
|
type - тип группы: 0 - модельная, 1 - временная.
|
|
Возвращаемое значение:
|
|
указатель на группу - в случае удачного завершения,
|
|
0 - в случае неудачи.
|
|
```
|
|
Примечание:
|
|
1. В модельной группе лежат объекты, которые уже созданы в документе. Во временной группе могут лежать временные и существующие объекты.
|
|
2. Если для временной группы не будет вызван функция StoreTmpGroup, то временные объекты группы будут уничтожены по окончании работы библиотеки.
|
|
3. Создаваемые в дальнейшем до вызова функции EndGroup объекты чертежа записываются в модель или во временный список объектов (например, для фантомной прорисовки при вводе).
|
|
4. Для дальнейшей обработки группы используются те же функции редактирования, что и для отдельных объектов, так как указатель на группу ничем не отличается от указателя на отдельный объект (оба они имеют тип reference).
|
|
5. Группа может объединять объекты вида, виды и слои.
|
|
6. При создании новой группы необязательно закрывать предыдущую (т.е. поддерживается вложенность групп).
|
|
|
|
|
|
## NewGroup, EndGroup - Пример использования
|
|
|
|
void NewGroup_Example (void) {
|
|
reference gr ;
|
|
double x,y,m,ang;
|
|
Phantom FANTOM;
|
|
gr = NewGroup(1); /* задание группы объектов */
|
|
LineSeg (-15, 0, 15, 0, 3); /* объекты записываются */
|
|
LineSeg ( 0, -15, 0, 15, 3); /* во временный список */
|
|
Circle (0, 0, 10, 1);
|
|
EndGroup(); /* закончить формирование группы */
|
|
/* ввод точки с отображением фантома и копирование группы*/
|
|
FANTOM.phType=1;
|
|
FANTOM.type1.gr=gr;
|
|
FANTOM.type1.xBase=0; FANTOM.type1.yBase=0;
|
|
FANTOM.type1.scale=1; FANTOM.type1.ang=0;
|
|
RequestInfo info;
|
|
memset(&info, 0, sizeof(info));
|
|
info.promt = " Точка привязки ";
|
|
if (Cursor(&info, &x, &y, &FANTOM))
|
|
CopyObj(gr, x, y, m, ang);
|
|
if (YesNo(Удалять?))
|
|
DeleteObj(gr);
|
|
}; /* NewGroup_Example */
|