---
title: "ClearGroup - Очистить группу объектов"
type: guide
api: [api7]
tags: [guide, api7, cleargroup]
sources:
  - cleargroup.html
---

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


## ClearGroup - Очистить группу объектов

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


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

void ClearGroup_Example (void)
{
reference gr ;
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(); // закончить формирование группы
//симметрия относительно оси X
if (Yes_No (Выполнять осевую симметрию))
{
SymmetryObj (gr, 0, 0, 100, 0, 0);
ClearGroup(gr); // очистка группы после использования
}
};
