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>
56 lines
2.2 KiB
Markdown
56 lines
2.2 KiB
Markdown
---
|
|
title: "ksGetGroupName - Получить имя группы по указателю на группу"
|
|
type: guide
|
|
api: [api7]
|
|
tags: [guide, api7, ksgetgroupname]
|
|
sources:
|
|
- ksgetgroupname.html
|
|
---
|
|
|
|
*API экспортных функций > Функции работы с графическим документом > Работа с группами объектов > Функции работы с группами объектов *
|
|
|
|
|
|
## ksGetGroupName - Получить имя группы по указателю на группу
|
|
|
|
Пример...
|
|
Аналог данной функции при использовании Automation - метод ksDocument2D::ksGetGroupName.
|
|
Синтаксис:
|
|
```
|
|
int ksGetGroupName (reference gr,
|
|
char *name,
|
|
int size);
|
|
Входные параметры:
|
|
gr - указатель на группу,
|
|
name - указатель строки для имени группы,
|
|
size - размер строки.
|
|
Выходной параметр:
|
|
-1 - у группы есть имя, но размер size меньше требуемой длины имени группы (имя не передается),
|
|
0 - ошибка указания группы,
|
|
1 - именная группа (имя есть),
|
|
2 - рабочая группа (имени нет).
|
|
Возвращаемое значение:
|
|
строка с именем группы.
|
|
Примечание.
|
|
При использовании Unicode следует использовать функцию ksGetGroupNameW.
|
|
```
|
|
|
|
|
|
## ksGetGroupName - Пример использования
|
|
|
|
//создаем рабочую группу
|
|
reference gr = NewGroup (0);
|
|
LineSeg (20, 20, 40, 20, 1);
|
|
LineSeg (40, 20, 40, 40, 1);
|
|
LineSeg (40, 40, 20, 40, 1);
|
|
LineSeg (20, 40, 20, 20, 1);
|
|
EndGroup ();
|
|
//рабочую группу сохраняем в именной
|
|
//именная группа хранится в документе
|
|
SaveGroup (gr, "group1");
|
|
char grName [255];
|
|
//получим имя группы
|
|
ksGetGroupName (gr, // указатель на группу
|
|
grName, // указатель строки для имени группы
|
|
255); // размер строки
|
|
Message (grName);
|