---
title: "GetGroup - Получить указатель на группу по ее имени"
type: guide
api: [api7]
tags: [guide, api7, getgroup]
sources:
  - getgroup.html
---

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


## GetGroup - Получить указатель на группу по ее имени

Пример...
Аналог данной функции при использовании Automation - метод ksDocument2D::ksGetGroup.
Синтаксис:
```
reference GetGroup (char *name);
Входной параметр:
name    - имя группы.
Возвращаемое значение:
указатель на группу    - в случае удачного завершения,
0    - в случае неудачи.
Примечание.
При использовании Unicode следует использовать функцию GetGroupW.
```


## GetGroup- Пример использования

void GetGroup_Example (void)
{
reference gr, p ;
gr = NewGroup(1); // задание группы объектов
LineSeg (-15, 0, 15, 0, 3); // объекты записываются
LineSeg ( 0, -15, 0, 15, 3); // во временный список
Circle (0, 0, 10, 1);
EndGroup(); // закончить формирование группы
SaveGroup (gr, Отверстие);
p = GetGroup (Отверстие);
LightObj (p, 1);
};