---
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);