---
title: "ExcludeObjGroup - Исключить объект из группы"
type: guide
api: [api7]
tags: [guide, api7, excludeobjgroup]
sources:
  - excludeobjgroup.html
---

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


## ExcludeObjGroup - Исключить объект из группы

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


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

void ExcludeObjGroup_Example (void) {
reference gr,p ;
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);
p = LineSeg(0, 0, 80, 0, 3); /* осевая линия */
EndGroup(); /* закончить формирование группы */
ExcludeObjGroup(gr, p); /* исключить объект p */
LightObj(gr, 1); /* подсветить группу */
if (Yes_No(Удалять группу?))
DeleteObj(gr);
}; /* ExcludeObjGroup_Example */