---
title: "SaveGroup - Сохранить группу объектов в документе"
type: guide
api: [api7]
tags: [guide, api7, savegroup]
sources:
  - savegroup.html
---

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


## SaveGroup - Сохранить группу объектов в документе

Пример...
Аналог данной функции при использовании Automation - метод ksDocument2D::ksSaveGroup.
Синтаксис:
```
int SaveGroup (reference group, char *name);
Входные параметры:
group    - указатель на группу,
name    - имя сохраняемой группы.
Возвращаемое значение:
1    - в случае успешного завершения,
0    - в случае неудачи.
```
Примечание:
1. Данный метод действителен только для модельной группы. После его выполнения группа автоматически сохраняется в чертеже при его записи. В противном случае группа действительна только в текущем сеансе работы. Если указатель группы равен нулю, то сохраняется группа селектирования (выделенные объекты документа).
2. При использовании Unicode следует использовать функцию SaveGroupW.


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

void SaveGroup_Example (void) {
reference gr ;
char name[40];
gr = NewGroup(0); /* определение группы объектов */
LineSeg (10, 10, 10, 20, 1); /* объекты записываются */
LineSeg (10, 20, 40, 20, 1); /* в модель текущего вида */
LineSeg (40, 20, 40, 30, 1);
LineSeg (40, 30, 70, 30, 1);
LineSeg (70, 30, 70, 10, 1);
LineSeg (70, 10, 10, 10, 1);
EndGroup(); /* закончить формирование группы */
LightObj(gr, 2); /* подсветить группу */
if (Yes_No(Сохранять группу в модели?)) {
ReadString(Имя группы, name, 40);
SaveGroup(gr, name);
}
LightObj(gr, 0); /* снять выделение группы */
}; /* SaveGroup_Example */