---
title: "SelectGroup - Автоматически сформировать группу объектов"
type: guide
api: [api7]
tags: [guide, api7, selectgroup]
sources:
  - selectgroup.html
---

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


## SelectGroup - Автоматически сформировать группу объектов

Пример...
Аналог данной функции при использовании Automation - метод ksDocument2D::ksSelectGroup.
Синтаксис:
```
int SelectGroup (reference group, int selectMode, double x1, double y1, double x2, double y2);
Входные параметры:
group    - указатель на группу,
selectMode    - тип выделения: 1 - объекты внутри прямоугольника-"ловушки", 2 - объекты снаружи прямоугольника-"ловушки", 3 - объекты, целиком или частично попавшие в прямоугольник-"ловушку".
x1, y1    - координаты левой нижней вершины прямоугольника-"ловушки",
x2, y2    - координаты правой верхней вершины прямоугольника-"ловушки".
Возвращаемое значение:
1    - в случае успешного завершения,
0    - в случае неудачи.
```
Примечание:
Если указатель на группу равен нулю, то добавление производится в группу выделения (т.е. происходит выделение объектов документа).


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

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